Fehler bei der Meet Media API beheben

In diesem Leitfaden finden Sie eine Anleitung zur Behebung häufiger Fehler bei der Google Meet Media API.

Fehlercodes beheben

Hier finden Sie Tipps zur Fehlerbehebung bei Fehlercodes, die vom Endpunkt connectActiveConference zurückgegeben werden:

Einheitlicher Plan

Wenn sich Datenkanäle nie öffnen und Sie nie Audio oder Video empfangen, prüfen Sie, ob bei der Konfiguration der lokalen Peer-Verbindung nur Unified Plan verwendet wird.

Fehler bei der Reihenfolge der Medienbeschreibung

Beim Erstellen einer Peer-to-Peer-Verbindung mit einem Session Description Protocol-Angebot (SDP) kann der folgende Fehler auftreten:

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.

Das bedeutet, dass die Zeilen mit der Medienbeschreibung in der SDP-Antwort nicht mit den Medienbeschreibungen im SDP-Angebot übereinstimmen:

Achten Sie darauf, dass ähnliche Medientypen richtig konfiguriert und gruppiert sind, wenn Sie das Peer-Verbindungsobjekt festlegen, um diesen Fehler zu beheben. Verschachtelte Medienbeschreibungen werden nicht unterstützt.

Das folgende Codebeispiel zeigt, wie die Media-Beschreibungen richtig abgeglichen werden:

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);
  // . . .
}

pc = new RTCPeerConnection();

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

Fehler beim DTLS-Rollenattribut

Beim Festlegen des DTLS-Rollenattributs wird möglicherweise der folgende Fehler angezeigt:

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

Dieser Fehler tritt auf, wenn das Attribut a=setup:< > für alle Medienbeschreibungen im SDP-Angebot nicht richtig festgelegt ist.

Um diesen Fehler zu beheben, muss jede Medienbeschreibung im SDP-Angebot eines der folgenden erforderlichen Attribute enthalten:

• 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
. . .

Probleme mit dem Ton beheben

Die folgenden Abschnitte können Ihnen helfen, Audioprobleme in Ihrer App zu beheben.

Log prüfen

Wenn Sie den Webclient in einem Chrome-Browser verwenden:

1. Öffnen Sie einen neuen Tab und geben Sie in die Adressleiste chrome://webrtc-internals ein.
2. Gehen Sie zum Abschnitt Stats graph for inbound-rtp.
3. Prüfen Sie jedes Audiogramm, um festzustellen, ob Pakete empfangen werden.

Wenn Sie den C++-Referenzclient verwenden, prüfen Sie, ob OnAudioFrame aufgerufen wird.

OAuth-Bereiche überprüfen

Audio wird nur übertragen, wenn der entsprechende Bereich mit der ursprünglichen Verbindungsanfrage angegeben wird. Achten Sie darauf, die richtigen OAuth 2.0-Bereiche anzugeben, um den Fehler zu beheben. Weitere Informationen finden Sie unter Meet Media API-Bereiche.

Prüfen, ob die Videokonferenz richtig eingerichtet ist

• Wenn der Client eine Verbindung zu den Google Meet-Servern herstellt, wird er nicht automatisch zur Videokonferenz zugelassen. Prüfen Sie, ob Sie über den Datenkanal für die Sitzungssteuerung ein Update der Sitzungssteuerungsressource mit dem Status STATE_JOINED erhalten haben.

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

• Prüfen Sie, ob es andere Konferenzteilnehmer gibt, deren Audiostreams nicht stummgeschaltet sind.

Signal für Audio überprüfen

Meet stellt nur Audio bereit, wenn Sie dies im SDP-Angebot angeben. Das Angebot muss drei Audio-Media-Beschreibungen enthalten, die nur zum Empfangen von Audioinhalten verwendet werden.

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
. . .

Wenn die Meet-Server ein gültiges Angebot erhalten, antworten sie mit einer SDP-Antwort mit drei Audio-Media-Beschreibungen, die nur gesendet werden können.

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
. . .

Observer-Implementierung überprüfen

Achten Sie darauf, Kopien der Audiodaten zu erstellen, wenn Sie die Datenverarbeitung in einen anderen Thread verschieben. AudioFrame.pcm16 ist im Grunde eine Referenz auf zugrunde liegende Daten. Wenn Sie also nach OnAudioFrame darauf zugreifen, führt das zu einem undefinierten Verhalten, z. B. einem Segmentierungsfehler.

Probleme bei Videos beheben

Die folgenden Abschnitte können Ihnen helfen, Videoprobleme in Ihrer App zu beheben.

Log prüfen

Wenn Sie den Webclient in einem Chrome-Browser verwenden:

1. Öffnen Sie einen neuen Tab und geben Sie in die Adressleiste chrome://webrtc-internals ein.
2. Gehen Sie zum Abschnitt Stats graph for inbound-rtp.
3. Prüfen Sie die Grafik für jedes Video, um zu sehen, ob Pakete empfangen werden.

Wenn Sie den C++-Referenzclient verwenden, prüfen Sie, ob OnVideoFrame aufgerufen wird.

OAuth-Bereiche überprüfen

Das Video wird nur übertragen, wenn der entsprechende Bereich mit der ursprünglichen Verbindungsanfrage angegeben wird. Achten Sie darauf, die richtigen OAuth 2.0-Bereiche anzugeben, um den Fehler zu beheben. Weitere Informationen finden Sie unter Meet Media API-Bereiche.

Prüfen, ob die Videokonferenz richtig eingerichtet ist

• Wenn der Client eine Verbindung zu den Meet-Servern herstellt, wird er nicht automatisch zur Videokonferenz zugelassen. Prüfen Sie, ob Sie über den Datenkanal für die Sitzungssteuerung ein Update der Sitzungssteuerungsressource mit dem Status STATE_JOINED erhalten haben.

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

• Prüfen Sie, ob es andere Konferenzteilnehmer gibt, deren Videostreams nicht stummgeschaltet sind.

Signal für Video bestätigen

Meet stellt nur dann Video bereit, wenn es im SDP-Angebot signalisiert wird. Das Angebot muss bis zu drei Nur-Empfang-Videomediabeschreibungen enthalten.

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
. . .

Wenn Meet ein gültiges Angebot erhält, antwortet es mit einer SDP-Antwort mit n Nur-Senden-Videomediabeschreibungen, wobei n die Anzahl der Videomediabeschreibungen im SDP-Angebot ist.

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
. . .

Fehlerbehebung bei fehlendem Video

• Prüfen Sie, ob m=video … im SDP-Angebot vorhanden ist, das an Meet-Server gesendet wird.
• Prüfen Sie, ob a=recvonly ein Attribut unter jeder m=video-Zeile ist.
• Prüfen Sie, ob in der SDP-Antwort die gleiche Anzahl von m=video-Zeilen vorhanden ist.
• Prüfen Sie, ob a=sendonly oder a=sendrecv Attribute unter jeder m=video-Zeile in der SDP-Antwort sind.
• Prüfen Sie, ob eine erfolgreiche VideoAssignmentRequest an die Meet-Server gesendet und von diesen empfangen wurde. Erfolg oder Fehler sollten über denselben Datenkanal an den Client zurückgegeben werden.

Weniger Videostreams als erwartet – Problembehebung

• Prüfen Sie, ob das SDP-Angebot die richtige Anzahl von m=video …-Zeilen enthält.
• Achten Sie darauf, dass alle m=video-Beschreibungen in der SDP-Antwort entweder ein a=sendonly- oder ein a=sendrecv-Attribut enthalten. Alle mit a=recvonly gekennzeichneten Zeilen in der Antwort reduzieren die Anzahl der an den Client gesendeten Streams um diesen Wert.

Observer-Implementierung überprüfen

Wenn Sie die Datenverarbeitung in einen anderen Thread verschieben, müssen Sie Kopien der Videodaten erstellen. VideoFrame.frame ist im Grunde eine Referenz auf zugrunde liegende Daten. Wenn Sie also nach OnVideoFrame darauf zugreifen, führt das zu undefiniertem Verhalten, z. B. einem Segmentierungsfehler.

Weitere Informationen

• Meet Media API-Konzepte