[無料] Enter"ed" Players List

商品名: [無料] Enter"ed" Players List

説明: 本商品は、VRChat 内のワールドに用いることを前提とした Unitypackage です。Unitypackage 内の構成については「内容物」を参照してください。

本商品は現在、インスタンスに入場したプレイヤー名(ここでいうプレイヤー名とは、VRCPlayerApi.displayName に当たります。)を取得することを目的として利用されます。取得可能なプレイヤー名には、プレイヤー入場時にインスタンス内にいないプレイヤーの名前も含まれることに留意してください。

本商品を用いたプレイヤー名の取得方法は2つあります。いずれも本商品内の`EnteredPlayerNameList`クラスを用いることに留意してください。

===

プレイヤー名取得方法 1. GetPlayerName

説明: プレイヤーID(VRCPlayerApi.playerId)と紐づいたプレイヤー名を取得します。

使用例*1:

```

// 最初に入場したプレイヤー名を取得・ログ出力する

string playerName = _enteredPlayerNameList.GetPlayerName(0);

Debug.Log(playerName);

```

2. GetPlayerNames

説明: インスタンスに入場した全プレイヤーの名前を取得します。戻り値のインデックスの値は、プレイヤーIDから-1した値です。

使用例*1:

```

// これまでに入場した全プレイヤーの ID と 名前 をログ出力する

string[] playerNames = _enteredPlayerNameList.GetPlayerName(0);

for(int i = 0; i < playerNames.Length; i++)

{

Debug.Log($"playerId = {i + 1}; Name is {playerNames[i]}");

}

```

===

内容物: 本商品には以下の構成で内容物が格納されています。

Assets

　└ BuildSoft

　　　├ Prefabs

　　　│ 　└ Player

　　　│ 　　　└ EnteredPlayersDisplay.cs

　　　├ Scene

　　　│ 　└ EnteredPlayerListSample.unity

　　　└ Scripts

　　　　　├ UdonSharp

　　　　　│ 　└ Player

　　　　　│ 　　　├ EnteredPlayerNameList.cs

　　　　　│ 　　　└ UI

　　　　　│ 　　　　　└ EnteredPlayersDisplay.cs

　　　　　└ UdonSharpAssets

　　　　　　　├ EnteredPlayerNameList.asset

　　　　　　　└ EnteredPlayersDisplay.asset

利用方法: Unityプロジェクトに本商品を import することで利用できます。本商品を利用する場合は、Unityプロジェクトに UdonSharp を import することが求められます。

UdonSharp は以下のURLからダウンロードすることが出来ます。

https://github.com/MerlinVR/UdonSharp/releases

[注記]

*1: 使用例は`EnteredPlayerNameList`クラスのフィールド`_enteredPlayerNameList`が存在することが前提として記述されています。

[補遺 - v1.1]

本商品がv1.1にアップデートされたことにより、以下の内容が修正されました。旧バージョンの継続的な使用は以下のバグに汚染され続けることを意味するため、速やかにアップデートすることが推奨されます。

・GetPlayerName メソッドの引数 playerId に現在取得中の playerId を入力すると OutOfRangeException によって UdonBehaviour が Inactive になる問題を修正