Meet Media API エラーのトラブルシューティングと修正

このガイドでは、Google Meet Media API の一般的なエラーを解決する方法について説明します。

エラーコードのトラブルシューティング

connectActiveConference エンドポイントから返されたエラーコードのトラブルシューティングのヒントを次に示します。

エラーコード
NO_ACTIVE_CONFERENCE Meet Media API クライアントが、認証済みのユーザーがすでに会議スペースの会議に参加している場合にのみ接続を試行していることを確認します。
INVALID_OFFER 特典の要件を読み、開設データに必要なチャネルなど、不足している詳細がないかどうかを確認します。アプリのオファー文字列をサンプル オファーと比較して、違いを確認することもできます。
INCOMPATIBLE_DEVICE 会議内の 1 つ以上のデバイスが Meet Media API クライアントと互換性がありません。アプリは参加できないため、エンドユーザーにその旨を伝える必要があります。
CONNECTIONS_EXHAUSTED 一度に会議に接続できる Meet Media API クライアントは 1 つのみです。アプリがクラッシュした場合、再接続しようとするとこのエラーが表示されることがあります。この場合は、Meet が以前の接続のタイムアウトになるまで 30 秒ほど待ちます。もう一度お試しください。

統合プラン

データチャネルが開かず、音声や動画を受信できない場合は、ローカル ピア接続の構成時に 統合プランのみが使用されていることを確認します。

メディアの説明の順序エラー

セッション記述プロトコル（SDP）オファーを使用してピアツーピア接続を作成するときに、次のエラーが表示されることがあります。

Failed to execute 'setRemoteDescription' on 'RTCPeerConnection':
Failed to set remote answer sdp:
The order of m-lines in answer doesn't match order in offer. Rejecting answer.

これは、SDP アンサーのメディアの説明行が SDP オファーのメディアの説明と一致しないことを意味します。

SDP 特典 SDP の回答
✅ m=audio 9 UDP/TLS/RTP/SAVPF 111 ✅ m=audio 9 UDP/TLS/RTP/SAVPF 111
❌ m=video 9 UDP/TLS/RTP/SAVPF 96 97 98 99 ❌ m=audio 9 UDP/TLS/RTP/SAVPF 111
✅ m=audio 9 UDP/TLS/RTP/SAVPF 111 ✅ m=audio 9 UDP/TLS/RTP/SAVPF 111
❌ m=audio 9 UDP/TLS/RTP/SAVPF 111 ❌ m=video 9 UDP/TLS/RTP/SAVPF 96 97 98 99

このエラーを修正するには、ピア接続オブジェクトを設定するときに、類似のメディアタイプが正しく設定され、グループ化されていることを確認します。インターリーブされたメディアの説明はサポートされていません。

次のコードサンプルは、メディアの説明を正しく照合する方法を示しています。

C++

rtc::scoped_refptr<webrtc::PeerConnectionInterface> peer_connection;

// Signal the entire video at once.
for (uint32_t i = 0; i < configurations.receiving_video_stream_count; ++i) {
    webrtc::RtpTransceiverInit video_init;
    video_init.direction = webrtc::RtpTransceiverDirection::kRecvOnly;
    video_init.stream_ids = {absl::StrCat("video_stream_", i)};

    webrtc::RTCErrorOr<rtc::scoped_refptr<webrtc::RtpTransceiverInterface>>
        video_result = peer_connection->AddTransceiver(
            cricket::MediaType::MEDIA_TYPE_VIDEO, video_init);
  // . . .
}

JavaScript

pc = new RTCPeerConnection();

// Signal the entire video at once.
pc.addTransceiver(video, {'direction':'recvonly'});
pc.addTransceiver(video, {'direction':'recvonly'});
pc.addTransceiver(video, {'direction':'recvonly'});

DTLS ロール属性エラー

DTLS ロール属性を設定するときに、次のようなエラーが表示されることがあります。

All DTLS roles must be one of [ACTIVE, ACTPASS].

このエラーは、SDP オファー内のすべてのメディアの説明に a=setup:< > 属性が正しく設定されていない場合に発生します。

このエラーを解決するには、SDP オファーの各メディアの説明に、次の必須属性のいずれかがあることを確認します。

  • a=setup:actpass
  • a=setup:active
v=0
o=- 4743178474630771513 3 IN IP4 127.0.0.1
s=-
t=0 0
a=group:BUNDLE 0 1
a=extmap-allow-mixed
a=msid-semantic: WMS
. . .
m=video 9 UDP/TLS/RTP/SAVPF 96 97 98 99 100 101
. . .
a=setup:actpass
. . .
m=audio 39807 UDP/TLS/RTP/SAVPF 111 63 9 0 8 13 110 126
. . .
a=setup:actpass
. . .

音声に関する問題のトラブルシューティング

以下のセクションでは、アプリの音声に関する問題の解決に役立つ情報を提供します。

ログを調べる

Chrome ブラウザでウェブ クライアントを使用している場合:

  1. 新しいタブを開き、アドレスバーに「chrome://webrtc-internals」と入力します。
  2. Stats graph for inbound-rtp というラベルのセクションに移動します。
  3. 各音声グラフを調べて、パケットが受信されているかどうかを確認します。

C++ リファレンス クライアントを使用している場合は、OnAudioFrame が呼び出されるかどうかを確認します。

OAuth スコープを確認する

音声は、最初の接続リクエストで適切なスコープが指定されている場合にのみ送信されます。このエラーを解決するには、正しい OAuth 2.0 スコープを指定してください。詳細については、Meet Media API のスコープをご覧ください。

会議が正しく設定されていることを確認する

  • クライアントが Google Meet サーバーに接続しても、会議に自動的に招待されることはありません。セッション制御データ チャネルを介して、状態が STATE_JOINED のセッション制御リソースの更新を受信していることを確認します。

    {"sessionStatus":{"connectionState":"STATE_JOINED"}}

  • 音声ストリームがミュートされていない他の会議の参加者がいることを確認します。

音声の電波を確認する

Meet は、SDP オファーでこれを通知した場合にのみ音声を提供します。オファーに3 つの受信専用の音声メディアの説明が存在している必要があります。

m=audio 39807 UDP/TLS/RTP/SAVPF 111 63 9 0 8 13 110 126
. . .
a=mid:0
. . .
a=recvonly
. . .
a=rtpmap:111 opus/48000/2
a=rtcp-fb:111 transport-cc
a=fmtp:111 minptime=10;useinbandfec=1
. . .
m=audio 9 UDP/TLS/RTP/SAVPF 111 63 9 0 8 13 110 126
. . .
a=mid:1
. . .
a=recvonly
. . .
a=rtpmap:111 opus/48000/2
a=rtcp-fb:111 transport-cc
a=fmtp:111 minptime=10;useinbandfec=1
. . .
m=audio 9 UDP/TLS/RTP/SAVPF 111 63 9 0 8 13 110 126
. . .
a=mid:2
. . .
a=recvonly
. . .
a=rtpmap:111 opus/48000/2
a=rtcp-fb:111 transport-cc
a=fmtp:111 minptime=10;useinbandfec=1
. . .

Meet サーバーが有効なオファーを受信すると、3 つの送信専用の音声メディアの説明を含む SDP レスポンスで応答します。

m=audio 19306 UDP/TLS/RTP/SAVPF 111
. . .
a=mid:0
. . .
a=sendonly
a=msid:virtual-6666 virtual-6666
. . .
a=rtpmap:111 opus/48000/2
a=fmtp:111 minptime=10;useinbandfec=1
. . .
m=audio 9 UDP/TLS/RTP/SAVPF 111
. . .
a=mid:1
. . .
a=sendonly
a=msid:virtual-6667 virtual-6667
. . .
a=rtpmap:111 opus/48000/2
a=fmtp:111 minptime=10;useinbandfec=1
. . .
m=audio 9 UDP/TLS/RTP/SAVPF 111
. . .
a=mid:2
. . .
a=sendonly
a=msid:virtual-6668 virtual-6668
. . .
a=rtpmap:111 opus/48000/2
a=fmtp:111 minptime=10;useinbandfec=1
. . .

オブザーバーの実装を確認する

データ処理を別のスレッドに移動する場合は、必ず音声データのコピーを作成してください。AudioFrame.pcm16 は実質的に基盤となるデータへの参照であるため、OnAudioFrame の後にアクセスしようとすると、セグメンテーション エラーなどの未定義の動作が発生します。

動画に関する問題のトラブルシューティング

以降のセクションでは、アプリの動画に関する問題の解決に役立つ情報を提供します。

ログを調べる

Chrome ブラウザでウェブ クライアントを使用している場合:

  1. 新しいタブを開き、アドレスバーに「chrome://webrtc-internals」と入力します。
  2. Stats graph for inbound-rtp というラベルのセクションに移動します。
  3. 各動画のグラフを調べて、パケットが受信されているかどうかを確認します。

C++ リファレンス クライアントを使用している場合は、OnVideoFrame が呼び出されるかどうかを確認します。

OAuth スコープを確認する

動画は、最初の接続リクエストで適切なスコープが指定されている場合にのみ送信されます。このエラーを解決するには、正しい OAuth 2.0 スコープを指定してください。詳細については、Meet Media API のスコープをご覧ください。

会議が正しく設定されていることを確認する

  • クライアントが Meet サーバーに接続しても、会議に自動的に招待されることはありません。セッション制御データ チャネルを介して、状態が STATE_JOINED のセッション制御リソースの更新を受信していることを確認します。

    {"sessionStatus":{"connectionState":"STATE_JOINED"}}

  • ビデオ ストリームがミュートされていない他の会議の参加者がいることを確認します。

動画のシグナルを確認する

Meet は、SDP オファーでシグナルが送信された場合にのみ動画を提供します。オファーには、受信専用の動画メディアの説明を 3 つまで含める必要があります。

v=0
o=- 4743178474630771513 3 IN IP4 127.0.0.1
s=-
t=0 0
a=group:BUNDLE 0 1
a=extmap-allow-mixed
a=msid-semantic: WMS
. . .
m=video 9 UDP/TLS/RTP/SAVPF 96 97 98 99 100 101 35 36 37 38 102 103 104 105 106 107 108 109 127 125 39 40 41 42 43 44 45 46 47 48 112 113 114 115 116 117 118 49
. . .
a=setup:actpass
a=mid:1
. . .
a=recvonly
. . .
a=rtpmap:96 VP8/90000
a=rtcp-fb:96 goog-remb
a=rtcp-fb:96 transport-cc
a=rtcp-fb:96 ccm fir
a=rtcp-fb:96 nack
a=rtcp-fb:96 nack pli
a=rtpmap:97 rtx/90000
a=fmtp:97 apt=96
. . .

Meet が有効なオファーを受信すると、n 個の送信専用の動画メディアの説明を含む SDP レスポンスで応答します。ここで、n は SDP オファー内の動画メディアの説明の数です。

v=0
o=- 0 2 IN IP4 127.0.0.1
s=-
t=0 0
a=group:BUNDLE 0 1
a=msid-semantic: WMS virtual-video-7777/7777
a=ice-lite
. . .
m=video 9 UDP/TLS/RTP/SAVPF 96 97 98 99
. . .
a=setup:passive
a=mid:1
. . .
a=msid:virtual-video-7777/7777 virtual-video-7777/7777
a=rtcp-mux
a=rtpmap:96 VP8/90000
a=rtcp-fb:96 ccm fir
a=rtcp-fb:96 nack
a=rtcp-fb:96 nack pli
a=rtcp-fb:96 goog-remb
. . .

動画が表示されない問題のトラブルシューティング

  • Meet サーバーに送信された SDP オファーに m=video … が存在することを確認します。
  • a=recvonly がすべての m=video 行の属性であることを確認します。
  • SDP レスポンスに同じ数の m=video 行が存在することを確認します。
  • SDP レスポンスのすべての m=video 行の属性が a=sendonly または a=sendrecv であることを確認します。
  • Meet サーバーに VideoAssignmentRequest が正常に送信され、受信されたことを確認します。成功または失敗は、同じデータチャネルを介してクライアントに通知する必要があります。

想定よりも少ない動画ストリーミングのトラブルシューティング

  • SDP オファーに正しい数の m=video … 行が含まれていることを確認します。
  • SDP レスポンスのすべての m=video の説明に a=sendonly 属性または a=sendrecv 属性が含まれていることを確認します。回答で a=recvonly とマークされた行は、クライアントに送信されるストリームの量をその分減らします。

オブザーバーの実装を確認する

データ処理を別のスレッドに移動する場合は、動画データのコピーを必ず作成してください。VideoFrame.frame は実質的に基盤となるデータへの参照であるため、OnVideoFrame の後にアクセスしようとすると、セグメンテーション エラーなどの未定義の動作が発生します。