Voice For PUN2

目次

• 概念
• 主要コンポーネント
  • PhotonVoiceNetwork
    • デフォルトのSpeakerFactory
    • 自動接続と入室
    • 自動退室と切断
    • PUN設定の使用
    • PUN認証値の使用
  • PhotonVoiceView
• 推奨ワークフロー
  • シーン設定 (PhotonVoiceNetwork)
  • プレハブの設定 (PhotonVoiceView)

概念

Voice for PUN2レイヤーのロジックは、従来のPhoton Voice 1またはPUNVoiceから継承されています。 Voiveクライアントの状態は、PUNのクライアント状態と自動的に同期させることができます。

主なユースケースは、各プレイヤーがオーディオが3Dに配置されているネットワークインスタンス化されたPUNプレハブ（キャラクターやアバター）を 保持している場合です。単一のオーディオストリームには、各エンドポイントに1つずつ、 合計2つのコンポーネント（RecorderとSpeaker）があります。PUNでは、これらはPhoton View IDを介してリンクされます。

トップに戻る

主要コンポーネント

PhotonVoiceNetwork

PhotonVoiceNetworkはVoiceConnectionを拡張し、PUN関連機能を追加します。デフォルトのSpeakerFactoryは上書きされ、 PUNとVoiceクライアントの状態を同期させる度合いを調整できます。また、PUNとVoiceは任意でPhotonServerSettingsから 同じAppSettingsを共有できます。

トップに戻る

デフォルトのSpeakerFactory

新しいファクトリーは、カスタムユーザーデータオブジェクトとして交換されたPhoton View IDを使用して、voiceストリーム情報に適したスピーカーを探します。

トップに戻る

自動接続と入室

PUNがルームに参加すると、Voiceクライアントも該当のVoiceルームに接続して参加することができます。

トップに戻る

自動退室と切断

PUNがルームを出ると、Voiceクライアントは自動的に切断されます。

トップに戻る

PUN設定の使用

VoiceクライアントがPUNのPhotonNetwork.PhotonServerSettingsと同様のAppSettingsを使用するか決定する設定です。 デフォルトでは、これはtrueです（有効化済み）。

トップに戻る

PUN認証値の使用

VoiceクライアントがPUNのPhotonNetwork.AuthValuesと同様のAuthenticationValuesを使用するか決定する設定です。 デフォルトでは、これはtrueです（有効化済み）。 この場合、VoiceアプリケーションにはPUNアプリケーションと同じカスタム認証ダッシュボード設定が必要です。

トップに戻る

PhotonVoiceView

PhotonVoiceViewは、ネットワークでインスタンス化されたPUNプレハブのためにRecorderとSpeakerを設定するコンポーネントです。

トップに戻る

推奨ワークフロー

シーン設定 (PhotonVoiceNetwork)

1. PUNのPhotonServerSettingsのAppSettingsでVoiceのAppIdを設定。
2. 必要に応じてPhotonVoiceNetworkをシーンに追加。
3. 必要に応じてPhotonVoiceNetwork.AutoConnectAndJoinをtrueに設定。
4. 必要に応じてPhotonVoiceNetwork.AutoLeaveAndDisconnectをtrueに設定。
5. 必要に応じてシーンにRecorderを追加し、プロパティを更新してPhotonVoiceNetwork.PrimaryRecorderに割り当てる。 5.a. 必要に応じてRecorder.TransmitEnabledを有効にして、準備ができ次第すぐに送信を開始することができます。 5.b. 必要に応じてRecorder.DebugEchoModeを有効にして自分の声を聞くことができます（ローカルスピーカーをリンクする必要があります。プレハブセットアップのステップ3.bを参照してください）。
6. 受信ボイスストリーム用のSpeakerインスタンスが見つからない場合に、それを作成するかどうか（6.a.）、また、その作成方法（6.b.）を任意で決定します。 6.a. 必要に応じてPhotonVoiceNetwork.AutoCreateSpeakerIfNotFoundをtrueに設定。 6.b. 必要に応じてSpeakerプレハブ（Speakerコンポーネントを含むプレハブ）を追加し、PhotonVoiceNetwork.SpeakerPrefabに割り当てる。

トップに戻る

プレハブの設定 (PhotonVoiceView)

1. PhotonViewが添付されているPUNプレハブのGameObjectにPhotonVoiceViewを追加する。

2. Recorder setup (2.a. or 2.b. or 2.c.):
   2.a. PhotonVoiceView.UsePrimaryRecorderをtrueに設定（PhotonVoiceNetwork.PrimaryRecorderを設定する必要があります）。 2.b. PhotonVoiceView.AutoCreateRecorderIfNotFoundをtrueに設定。

   • レコーダーを作成したら、photonVoiceView.RecorderInUse.TransmitEnabledをtrueに設定して、手動で送信を開始する必要があります。
   • 自分の声を聞くには、photonVoiceView.RecorderInUse.DebugEchoModeをtrueに設定してください（ローカルスピーカーをリンクする必要があります。手順3.bを参照してください）。

   2.c. Recorderをプレハブに追加し、そのプロパティを更新してPhotonVoiceView.RecorderInUseに割り当てます。

   • 必要に応じてRecorder.TransmitEnabledを有効にして、準備ができ次第すぐに送信を開始することができます。
   • 必要に応じてRecorder.DebugEchoModeを有効にして自分の声を聞くことができます（ローカルスピーカーをリンクする必要があります。手順3.bを参照してください）。
3. スピーカーの設定：
   3.a. 必要に応じて、プレハブにSpeakerを追加してPhotonVoiceView.SpeakerInUseに割り当てる。
   3.b. 必要に応じてPhotonVoiceView.SetupDebugSpeakerを有効にします（Recorder.DebugEchoModeが有効になっている場合に必要）。

ドキュメントのトップへ戻る