組み込み関数 - ネットワーク
情報
ルームのプレイヤー全体に、任意のデータを送信します。
プレイヤーにデータを送信する方法として、カスタムステートとカスタムデータの2種類があります。
カスタムステートは、新しくルームに入ってきたプレイヤーへ自動的にデータが送信されます。
カスタムデータは、1回きりの送信を実現するものです。
それぞれ、以下の関数を利用してデータを送信します。type には任意の文字列を指定できますが、利用目的に応じた適切な名前を選択することが好ましいです。
hsNetSetCustomState(string, string)
void hsNetSetCustomState(string type, string data)
あらかじめ type と data を設定しておくことによって、ルームに入場したユーザーに (type, data) を自動で通知する。
hsNetSendCustomData(string, string)
void hsNetSendCustomData(string type, string data)
ルーム内のユーザーに (type, data) を通知する。
データ受信コールバックメソッド
送信されたデータは、コンポーネントに定義された OnReceiveCustomState()
と OnReceiveCustomData()
メソッドで取得できます。引数 id は送信したプレイヤーの識別子です。
component CustomDataReceiver
{
public void OnReceiveCustomState(string id, string type, string data)
{
}
public void OnReceiveCustomData(string id, string type, string data)
{
}
}
音声チャンネル入退出コールバックメソッド
他のユーザーの音声チャンネルへの入退出はOnVCPlayerJoin()
とOnVCPlayerLeave()
メソッドで取得できます。引数 ID は送信したプレイヤーの識別子です。
component JoinLeaveSample
{
public void OnVCPlayerJoin(string ID, string Data)
{
}
public void OnVCPlayerLeave(string ID, string Data)
{
}
}
マイク許可状態
hsNetGetMicPermissionState
int hsNetGetMicPermissionState()
マイク許可状態を取得します。以下の定数値が返ります。
const int HSMicPermissionState_Prompt = 0; // 確認が必要
const int HSMicPermissionState_Granted = 1; // 許可
const int HSMicPermissionState_Denied = 2; // 不許可
コールバックメソッド
以下のメソッドを定義しておくと、マイク状態が変更されたときに呼び出されます。
public void OnChangedMicPermissionState(int MicPermissionState)
{
}
SpatiumCode
hsNetGetSpatiumCode
string hsNetGetSpatiumCode()
Sceneファイルに定義されたSpatiumCodeを取得します。