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

プレイヤーデータ型

Player Data Types World Preview

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

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

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

例の使用方法

クライアントでの操作:

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

エディタでの操作:

  1. VRChat SDK > ClientSim Player Data エディタウィンドウを開きます
  2. Play Modeでボタンを押すと、こちらでもテストデータが更新されることを確認します
  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 データ型をサポートしています。

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

最終更新: