VRChat 非公式日本語ドキュメント

プレイヤーデータ型

プレイヤーデータ型のワールドプレビュー

PlayerDataインターフェースでサポートされているデータ型を示す最小限のサンプルです。

Player Data Types Example World」にアクセスして、実際に試してみてください!

サポートされているデータ型は以下の通りです:

  • bool
  • byte
  • byte[]
  • int
  • float
  • double
  • long
  • short
  • string
  • sbyte
  • uint
  • ulong
  • ushort
  • Vector2
  • Vector3
  • Vector4
  • Quaternion
  • Color
  • Color32

サンプルの使用方法

クライアントでの操作:

  1. ワールドに入る
  2. 「Set Test Data」ボタンをクリックする
  3. 表示がテストデータで更新されることを確認する

エディタでの操作:

  1. VRChat SDK > ClientSim Player Data」エディタウィンドウを開く
  2. プレイモード中にボタンを押すと、ここでもテストデータが更新されることを確認する
  3. テストデータを消去したり、再設定したりできます
  4. テストデータを含むJSONファイルを開いて手動で更新し、エディタウィンドウの「Refresh」を押すことで、更新されたテストデータを表示できます

サンプルのインポート方法

以下の手順に従って、このサンプルをUnityプロジェクトに追加してください:

  1. Unityエディタのメニューから「VRChat SDK > 🏠 Example Central」を選択し、「Example Central」ウィンドウを開きます。
  2. リストからこのプレハブを探すか、タイトル(このページのタイトルと同じ)で検索します。
  3. 「Import」ボタンを押して、Unitypackageをプロジェクトにインポートします。

技術的な解説

この PlayerDataController には、シーン内のボタンから呼び出されてプレイヤーデータのサンプルを設定する SetTestData メソッドがあります。

OnPlayerDataUpdated メソッドを使用して、プレイヤーデータの更新を監視します。ローカルプレイヤーのデータが変更されたかどうかを確認し、変更されていれば新しいデータを取得して読み取り可能な文字列に整形します。この文字列には、データの種類(bool、int、string)や、プレイヤーの固有IDに関連付けられた値といった詳細が含まれます。

整形されたデータは、TextMeshProUGUI componentを使用して画面に表示されます。

このスクリプトには、PlayerDataToStringというヘルパー関数が含まれており、特定のキーの下に保存されたデータの型を確認して表示可能な文字列に変換します。この関数は、すべての永続化可能な(Persistable)データ型をサポートしています。

プレイヤーデータの型が認識できない場合は、不明な型であることを示すエラーメッセージを出力します。

最終更新: