ご注意：
GME 3.xバージョンは現在、リアルタイム音声ロール設定機能をサポートしていません。
開発者がTencent Cloud GME製品のAPIを容易にデバッグして導入するために、このドキュメントではGMEのコマンダーモードの導入手順を紹介します。
シナリオ
ウォーゲームのシーンで、GMEはキャスターとオーディエンスの2種類のロールを提供します。ルームに参加する前にキャスターを設定した場合、ルームに参加した後マイクをオンにして発言したり、スピーカーをオンにしてルーム内のコミュニケーション音声を聞くことができます。オーディエンスとしてルームに参加した場合、ルームに参加した後マイクをオンにしてもルーム内で発言することができません。
前提条件
GMEアプリケーションの作成が完了し、SDK AppIDとKeyを取得しました。サービス有効化ガイドをご参照ください。 統合の手順
ウォーゲーム音声モードを導入する手順は次の通りです：
ステップ1：GMEサービスの利用
ステップ2：ロールの設定
ルーム参加EnterRoomインターフェースを呼び出す前に、ロール設定インターフェースを呼び出して、リアルタイム音声でローカル側のロールを設定する必要があります。
関数のプロトタイプ
public abstract int SetAudioRole(ITMG_AUDIO_MEMBER_ROLE role);
|
| | ITMG_AUDIO_MEMBER_ROLE_ANCHORはキャスターを表し、ルーム内でマイクとスピーカーをオンにすることができます ITMG_AUDIO_MEMBER_ROLE_AUDIENCEはオーディエンスを表し、ルーム内でスピーカーのみをオンにして聞くことができます |
サンプルコード
ITMGContext.GetInstance().SetAudioRole(ITMG_AUDIO_MEMBER_ROLE.ITMG_AUDIO_MEMBER_ROLE_AUDIENCE);
ステップ3：リアルタイム音声サービスの利用
EnterRoomインターフェースを呼び出して、リアルタイム音声ルームに入ります。
ステップ4： マイクをオンにする
ロールがキャスターの場合は、EnableMicインターフェースとEnableSpeakerインターフェースを正常に呼び出してマイクとスピーカーをオンにすることができます。
ロールがオーディエンスの場合、EnableSpeakerインターフェースを正常に使用してスピーカーをオンにすることができますが、EnableMicインターフェースを呼び出すとAV_ERR_INVALID_ARGUMENT（1004）エラーコードが返され、この時点ではオーディエンスモードであり、マイクのオンは無効であることが表示されます。
ステップ5：ロールの切り替え
ルーム内でSetAudioRoleを呼び出してロールを変更することができます。
ロールが設定されていない場合、新しく設定されたロールに切り替えます。
ロールが設定された場合は、新しく設定されたロールに切り替えます。
この時点でロールが設定されていない場合、またはキャスターである場合、通常の通話が行われるようマイクがオンの状態で、オーディエンスのロールに切り替えると、マイクがオンのままです。この場合、業務レベルではEnableMicインターフェースを呼び出してマイクの状態とマイクUIの状態を変更することをお勧めします。
手順6：ルーム退出
ExitRoomインターフェースを呼び出してリアルタイム音声ルームを終了すると、ロール状態が無効になり、ロールを再設定してください。