此页面由 Cloud Translation API 翻译。

排查和修复 Meet Media API 错误

本指南介绍了如何解决常见的 Google Meet Media API 错误。

排查错误代码问题

以下是有关排查 connectActiveConference 端点返回的错误代码的问题的提示：

错误代码
`NO_ACTIVE_CONFERENCE`	检查 Meet Media API 客户端是否仅在经过身份验证的用户已加入会议室中的会议后才尝试连接。
`INVALID_OFFER`	仔细阅读商品要求，检查是否缺少任何详细信息，例如是否已开设数据流量所需的渠道。您还可以将应用的商品字符串与示例商品进行比较，并调查是否存在任何差异。
`INCOMPATIBLE_DEVICE`	会议中的一台或多台设备与 Meet Media API 客户端不兼容。您的应用将无法加入，因此您可能需要向最终用户说明这一点。
`CONNECTIONS_EXHAUSTED`	一次只能有一个 Meet Media API 客户端连接到一个会议。如果您的应用发生崩溃，当它尝试重新连接时，您可能会看到此错误。在这种情况下，请等待大约 30 秒，让 Meet 超时之前的连接。然后，再试一次。

统一方案

如果数据通道从未打开，并且您从未收到音频或视频，请检查配置本地对等连接时是否仅使用了统一方案。

媒体说明顺序错误

使用 Session Description Protocol (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 浏览器中使用 Web 客户端，请执行以下操作：

打开一个新标签页，然后在地址栏中输入：chrome://webrtc-internals。
前往标记为 Stats graph for inbound-rtp 的部分。
检查每个音频图表，看看是否正在接收数据包。

如果您使用的是 C++ 参考客户端，请检查是否曾调用 OnAudioFrame。

验证 OAuth 范围

只有在初始连接请求中提供适当的范围时，系统才会传输音频。如需解决此错误，请务必提供正确的 OAuth 2.0 范围。如需了解详情，请参阅 Meet Media API 权限范围。

验证会议是否已正确设置

当客户端连接到 Google Meet 服务器时，系统不会自动将其加入会议。确保您已通过会话控制数据通道收到状态为 STATE_JOINED 的会话控制资源更新。
```
{"sessionStatus":{"connectionState":"STATE_JOINED"}}
```
确认其他会议参与者的音频流没有静音。

检查音频信号

只有在您在 SDP 报价中指明这一点时，Meet 才会提供音频。商品中必须包含三个仅限接收的音频媒体说明。

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 服务器收到有效的 offer，则会响应一个 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 浏览器中使用 Web 客户端，请执行以下操作：

打开一个新标签页，然后在地址栏中输入：chrome://webrtc-internals。
前往标记为 Stats graph for inbound-rtp 的部分。
检查每个视频图表，看看是否正在接收数据包。

如果您使用的是 C++ 参考客户端，请检查是否曾调用 OnVideoFrame。

验证 OAuth 范围

仅当初始连接请求中提供了适当的范围时，才会传输视频。如需解决此错误，请务必提供正确的 OAuth 2.0 范围。如需了解详情，请参阅 Meet Media API 权限范围。

验证会议是否已正确设置

当客户端连接到 Meet 服务器时，系统不会自动将其加入会议。确保您已通过会话控制数据通道收到状态为 STATE_JOINED 的会话控制资源更新。
```
{"sessionStatus":{"connectionState":"STATE_JOINED"}}
```
确认其他会议参与者的视频画面未被静音。

验证视频信号

Meet 仅在 SDP 报价中发出视频信号时提供视频。商品中最多只能包含三个仅限接收的视频媒体说明。

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 之后尝试访问它将导致未定义的行为，例如分段错误。

了解 Media API 概念

排查和修复 Meet Media API 错误

排查错误代码问题

统一方案

媒体说明顺序错误

C++

JavaScript

DTLS 角色属性错误

排查音频问题

查看日志

验证 OAuth 范围

验证会议是否已正确设置

检查音频信号

检查您的观察器实现

排查视频问题

查看日志

验证 OAuth 范围

验证会议是否已正确设置

验证视频信号

排查没有视频的问题

排查视频串流数量少于预期的问题

检查您的观察器实现

相关主题