ストリームプレハブ¶
Streams
プレハブオブジェクトは、配信セッションに使用するゲームからのデータストリーミングを定義します。1 つの Streams
オブジェクトに複数のデータストリームを持たせることができます。アプリケーションに複数のデータストリームが必要な場合、 Ids
メンバーのサイズを変更する必要があります。この配列の各要素には、変更可能ないくつかのプロパティが含まれています。
- Id
- データストリームの名前です。アプリケーションで使用される他のストリームに対して、一意の名前を使用してください。
- Framerate
「On Submit Stream」 機能の実行頻度です。デフォルト値は 0。
0は、ストリームデータがフレームごとに送信されることを意味します (ゲームのフレームレートに直接依存) 。
他のすべての値は、Min(value, Game Framerate) という式を使用します。
たとえば、30FPS で動作するゲームでは、
- 値10では、ストリームは、Min(10, 30) = 10 フレーム/秒で送信されます。
- 値100では、ストリームは、Min(100, 30) = 30 フレーム/秒で送信されます。
- On Submit Stream (String)
選択されたフレームレートに従って実行される機能です。受け取った String のパラメータが常にストリーム名になります。その後、呼び出されるメソッドで、最適なデータの送信方法を自由に選択することができます。
- SubmitAnnotation(オブジェクトの streamID, オブジェクトデータ)
- SubmitGameData(オブジェクトの streamID, オブジェクトデータ)
- SubmitGameDataJSON (オブジェクトの streamID, オブジェクトデータ)
- SubmitAnnotationJSON (オブジェクトの streamID, オブジェクトデータ)
- SubmitNotificationJSON(オブジェクトの notificationID, オブジェクトデータ)
注釈
データを送信する際に利用できる3つの方法の1つである、通知機能をここで紹介します。しかし、通知をストリームで送信することは not であるため、
Streams
プレハブは非推奨とされ、GenvidSession
プレハブに移動されました。警告
後に 「JSON」 が付く submit 関数は、シリアライズ可能な JSON オブジェクトのみをサポートしています。
JSON で終わる各メソッドには次のものが必要です。
- データを受け取るストリーム名
- byte [] のシリアライズデータまたは文字列
JSON で終わらない各メソッドには次のものが必要です。
- データを受け取るストリーム名
- JSON でシリアライズ可能なデータ
Unity キューブサンプルでは、Streams
プレハブを使用して、著作権、キューブ名、キューブの位置、キューブの色、カメラ情報などのデータを送信します。上記のデータ型は、それぞれストリームと提出頻度が決まっています。より良い組織と柔軟性のために、専用のデータストリームをこのパターンに従って使用することをお勧めします。