แก้ปัญหาและแก้ไขข้อผิดพลาดของ Meet Media API

คู่มือนี้มีวิธีการแก้ข้อผิดพลาดทั่วไปของ Google Meet Media API

แก้ปัญหารหัสข้อผิดพลาด

เคล็ดลับในการแก้ปัญหารหัสข้อผิดพลาดที่ปลายทาง connectActiveConference แสดงผลมีดังนี้

แพ็กเกจ Unified

หากช่องข้อมูลไม่เปิดขึ้นและคุณไม่ได้รับเสียงหรือวิดีโอ ให้ตรวจสอบว่าใช้ Unified Plan เท่านั้นเมื่อกำหนดค่าการเชื่อมต่อเพียร์ในเครื่อง

ข้อผิดพลาดเกี่ยวกับลำดับคำอธิบายสื่อ

เมื่อสร้างการเชื่อมต่อแบบเพียร์ทูเพียร์ด้วยข้อเสนอ 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

หากต้องการแก้ไขข้อผิดพลาดนี้ ให้ตรวจสอบว่ามีการกำหนดค่าประเภทสื่อที่คล้ายกันอย่างถูกต้องและจัดกลุ่มไว้ด้วยกันเมื่อตั้งค่าออบเจ็กต์การเชื่อมต่อเพียร์ ระบบไม่รองรับคำอธิบายสื่อแบบสลับกัน

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีจับคู่คำอธิบายสื่ออย่างถูกต้อง

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'});

ข้อผิดพลาดเกี่ยวกับแอตทริบิวต์บทบาท DTLS

เมื่อตั้งค่าแอตทริบิวต์บทบาท DTLS คุณอาจเห็นข้อผิดพลาดต่อไปนี้

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

ข้อผิดพลาดนี้เกิดขึ้นเมื่อไม่ได้ตั้งค่าแอตทริบิวต์ a=setup:< > อย่างถูกต้องสำหรับ คำอธิบายสื่อทั้งหมดในข้อเสนอ SDP

หากต้องการแก้ไขข้อผิดพลาดนี้ ให้ตรวจสอบว่าคำอธิบายสื่อแต่ละรายการในข้อเสนอ SDP มีแอตทริบิวต์ที่จำเป็นต่อไปนี้อย่างน้อย 1 รายการ

• 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 offer ข้อเสนอต้องมีคำอธิบายสื่อเสียงแบบรับอย่างเดียว สาม รายการใน ข้อเสนอ

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 ได้รับข้อเสนอที่ถูกต้อง เซิร์ฟเวอร์จะตอบกลับด้วยการตอบกลับ SDP ที่มีคำอธิบายสื่อเสียงแบบส่งอย่างเดียว 3 รายการ

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 offer ข้อเสนอต้องมีคำอธิบายสื่อวิดีโอแบบรับอย่างเดียวไม่เกิน 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 ได้รับข้อเสนอที่ถูกต้อง เซิร์ฟเวอร์จะตอบกลับด้วยการตอบกลับ SDP ที่มีคำอธิบายสื่อวิดีโอแบบส่งอย่างเดียว n รายการ โดยที่ 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
. . .

แก้ปัญหาที่ไม่มีวิดีโอ

• ตรวจสอบว่า m=video … อยู่ในข้อเสนอ SDP ที่ส่งไปยังเซิร์ฟเวอร์ Meet
• ตรวจสอบว่า a=recvonly เป็นแอตทริบิวต์ใต้บรรทัด m=video ทุกบรรทัด
• ตรวจสอบว่ามีการระบุบรรทัด m=video จำนวนเท่ากันในการตอบกลับ SDP
• ตรวจสอบว่า a=sendonly หรือ a=sendrecv เป็นแอตทริบิวต์ใต้บรรทัด m=video ทุกบรรทัดในการตอบกลับ SDP
• ตรวจสอบว่ามีการส่งและรับ VideoAssignmentRequest ที่สำเร็จไปยังเซิร์ฟเวอร์ Meet ระบบควรแจ้งผลลัพธ์ (สำเร็จหรือไม่สำเร็จ) กลับไปยังไคลเอ็นต์ผ่านช่องข้อมูลเดียวกัน

แก้ปัญหาสตรีมวิดีโอน้อยกว่าที่คาดไว้

• ตรวจสอบว่าข้อเสนอ SDP มีบรรทัด m=video … จำนวนที่ถูกต้อง
• ตรวจสอบว่าคำอธิบาย m=video ทั้งหมดในการตอบกลับ SDP มีแอตทริบิวต์ a=sendonly หรือ a=sendrecv บรรทัดที่ทำเครื่องหมาย a=recvonly ในการตอบกลับจะลดจำนวนสตรีมที่ส่งไปยังไคลเอ็นต์ตามจำนวนบรรทัดดังกล่าว

ตรวจสอบการใช้งานออบเซิร์ฟเวอร์

อย่าลืมทำสำเนาข้อมูลวิดีโอหากคุณย้ายการประมวลผลข้อมูลไปยังเธรดอื่น VideoFrame.frame เป็นการอ้างอิงข้อมูลพื้นฐานอย่างมีประสิทธิภาพ ดังนั้นการพยายามเข้าถึงข้อมูลนี้หลังจาก OnVideoFrame จะทำให้เกิดลักษณะการทำงานที่ไม่แน่นอน เช่น ข้อผิดพลาดในการแบ่งส่วน

หัวข้อที่เกี่ยวข้อง

• แนวคิดเกี่ยวกับ Meet Media API