- 製品アップデート情報
- 製品紹介
- 初心者ガイド
- 購入ガイド
- SDKダウンロードガイド
- 製品機能体験
- コンソールガイド
- クイックスタート
- 基本機能開発ガイド
- 拡張機能開発ガイド
- クライアントAPI
- Server APIs
- よくある質問
- Service Agreement
- お問い合わせ
- 用語集
- GME ポリシー
- 製品アップデート情報
- 製品紹介
- 初心者ガイド
- 購入ガイド
- SDKダウンロードガイド
- 製品機能体験
- コンソールガイド
- クイックスタート
- 基本機能開発ガイド
- 拡張機能開発ガイド
- クライアントAPI
- Server APIs
- よくある質問
- Service Agreement
- お問い合わせ
- 用語集
- GME ポリシー
ご注意：
GME 3.xバージョンは現在、リアルタイム音声ロール設定機能をサポートしていません。
開発者がTencent Cloud GME製品のAPIを容易にデバッグして導入するために、このドキュメントではGMEのコマンダーモードの導入手順を紹介します。
シナリオ
ウォーゲームのシーンで、GMEはキャスターとオーディエンスの2種類のロールを提供します。ルームに参加する前にキャスターを設定した場合、ルームに参加した後マイクをオンにして発言したり、スピーカーをオンにしてルーム内のコミュニケーション音声を聞くことができます。オーディエンスとしてルームに参加した場合、ルームに参加した後マイクをオンにしてもルーム内で発言することができません。
前提条件
GMEアプリケーションの作成が完了し、SDK AppIDとKeyを取得しました。サービス有効化ガイドをご参照ください。
リアルタイム音声サービスを有効にしました。サービス有効化ガイドをご参照ください。
GME SDKの導入が完了しました。SDKの快速導入をご参照ください。
統合の手順
ウォーゲーム音声モードを導入する手順は次の通りです：
1. GMEサービスの使用
2. ロールの設定
3. リアルタイム音声サービスの使用
4. マイクオン
5. ロールの変更
6. ルーム退出
ステップ1：GMEサービスの利用
ステップ2：ロールの設定
ルーム参加EnterRoomインターフェースを呼び出す前に、ロール設定インターフェースを呼び出して、リアルタイム音声でローカル側のロールを設定する必要があります。
関数のプロトタイプ
public abstract int SetAudioRole(ITMG_AUDIO_MEMBER_ROLE role);
パラメータ | タイプ | 意味 |
role | ITMG_AUDIO_MEMBER_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インターフェースを呼び出してリアルタイム音声ルームを終了すると、ロール状態が無効になり、ロールを再設定してください。
はい
いいえ
この記事はお役に立ちましたか？