คู่มือนี้จะแสดงวิธีการแก้ไขข้อผิดพลาด SDK ของส่วนเสริม Google Meet ที่เฉพาะเจาะจงซึ่งคุณอาจพบขณะสร้างและทดสอบส่วนเสริมของ Meet
หากต้องการดูรายละเอียดเกี่ยวกับข้อผิดพลาด ให้ใช้ออบเจ็กต์ MeetAddonError โดยจะมีพร็อพเพอร์ตี้ errorType ที่ระบุประเภทข้อผิดพลาด
ประเภทของข้อผิดพลาด
ต่อไปนี้คือประเภทข้อผิดพลาดที่เกิดขึ้นเมื่อ SDK ของส่วนเสริม Meet แสดงข้อผิดพลาด พร้อมกับคำอธิบายเกี่ยวกับวิธีตีความและคำแนะนำเกี่ยวกับสิ่งที่ต้องทำเมื่อพบข้อผิดพลาด
| ข้อผิดพลาด | ข้อความแสดงข้อผิดพลาด | การดำเนินการ |
|---|---|---|
ActivityIsOngoing |
ดำเนินการไม่ได้ขณะที่กิจกรรมดำเนินอยู่ | ตรวจสอบว่ากิจกรรมไม่ได้ดำเนินอยู่ |
ActivityStartingStateEmpty |
สถานะการเริ่มกิจกรรมว่างเปล่า | มีการจัดหาออบเจ็กต์ ActivityStartingState แต่ไม่มีแอตทริบิวต์ใดๆ |
ActivityStartingStateMissingAttributes |
สถานะเริ่มต้นของกิจกรรมไม่มีแอตทริบิวต์ที่รู้จัก | ตรวจสอบว่าออบเจ็กต์ ActivityStartingState มีแอตทริบิวต์ต่อไปนี้อย่างน้อย 1 รายการ ได้แก่ mainStageUrl, sidePanelUrl หรือ additionalData |
ActivityStartingStateUnrecognizedAttributes |
สถานะเริ่มต้นของกิจกรรมมีแอตทริบิวต์ที่ระบบไม่รู้จัก | ตรวจสอบว่าออบเจ็กต์ ActivityStartingState มีแอตทริบิวต์เพียง mainStageUrl, sidePanelUrl หรือ additionalData เท่านั้น |
AddonSessionAlreadyCreated |
มีการสร้างเซสชันของส่วนเสริมแล้ว | สร้างอินสแตนซ์ AddonSession เพียงครั้งเดียว |
AddonStartingStateMissingAttributes |
สถานะเริ่มต้นของส่วนเสริมไม่มีแอตทริบิวต์ที่รู้จัก | ตรวจสอบว่าออบเจ็กต์ AddonStartingState มีแอตทริบิวต์ต่อไปนี้อย่างน้อย 1 รายการ sidePanelUrl, additionalData |
AddonStartingStateUnrecognizedAttributes |
สถานะเริ่มต้นของส่วนเสริมมีแอตทริบิวต์ที่ระบบไม่รู้จัก | ตรวจสอบว่าออบเจ็กต์ AddonStartingState มีแอตทริบิวต์เพียง 2 รายการต่อไปนี้เท่านั้น sidePanelUrl, additionalData |
ArgumentNullError |
ค่าของออบเจ็กต์ที่ระบุเป็นค่าว่างในตำแหน่งที่ควรเป็นค่า | ตรวจสอบว่าคุณส่งค่าของประเภทที่คาดไว้สำหรับอาร์กิวเมนต์ |
ArgumentTypeError |
ประเภทของออบเจ็กต์ที่ระบุไม่ตรงกับประเภทที่คาดไว้ | ตรวจสอบว่าประเภทของอาร์กิวเมนต์ที่ระบุตรงกับประเภทที่คาดไว้ |
DestinationNotReady |
เฟรมของผู้รับไม่ได้เชื่อมต่อโดยใช้ SDK ของส่วนเสริม Meet และไม่สามารถรับการแจ้งเตือน | ตรวจสอบว่าเฟรมปลายทางเชื่อมต่ออยู่ก่อนส่งข้อความ |
InternalError |
เกิดข้อผิดพลาดภายในของ Meet | ไม่มีข้อมูลเพิ่มเติม |
InvalidActivityStartingState |
ActivityStartingState URL ของ iframe ไม่ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม |
ตรวจสอบว่าต้นทาง URL ของ ActivityStartingState iframe ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม โปรดดูข้อมูลเพิ่มเติมที่หัวข้อความปลอดภัยของส่วนเสริม |
InvalidAddonStartingState |
AddonStartingState URL ของ iframe ไม่ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม |
ตรวจสอบว่าต้นทาง URL ของ AddonStartingState iframe ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม |
InvalidCloudProjectNumber |
หมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ Meet ระบุไม่ตรงกับหมายเลขที่ SDK ของส่วนเสริม Meet ส่งเข้ามา | ตรวจสอบว่าได้ส่งหมายเลขโปรเจ็กต์ Cloud ที่ถูกต้องเป็นสตริงไปยัง SDK เมื่อเรียกใช้พร็อพเพอร์ตี้ createAddonSession หรือเมธอด exposeToMeetWhenScreenSharing() Meet จะเพิ่มพารามิเตอร์นี้ต่อท้าย URL ของ iframe โดยอัตโนมัติ โปรดตรวจสอบว่าโครงสร้างพื้นฐานของคุณไม่ได้แก้ไขพารามิเตอร์ของ URL (เช่น เป็นส่วนหนึ่งของการเปลี่ยนเส้นทาง) ก่อนใช้ค่าที่ส่ง |
MissingUrlParameter |
ไม่มีพารามิเตอร์ URL ของ SDK สำหรับส่วนเสริมของ Meet ที่จำเป็น | Meet จะเพิ่มพารามิเตอร์นี้ต่อท้าย URL ของ iframe โดยอัตโนมัติ ตรวจสอบว่าโครงสร้างพื้นฐานไม่ได้แก้ไขพารามิเตอร์ของ URL (เช่น เป็นส่วนหนึ่งของการเปลี่ยนเส้นทาง) |
NeedsMainStageContext |
คุณจะเรียกใช้เมธอดนี้ได้ก็ต่อเมื่อส่วนเสริมทำงานอยู่ในเวทีหลักเท่านั้น | ใช้พร็อพเพอร์ตี้ getFrameType เพื่อตรวจสอบว่าส่วนเสริมทํางานอยู่ในระยะหลักหรือไม่ก่อนที่จะเรียกใช้เมธอดนี้ |
NeedsSidePanelContext |
คุณจะเรียกใช้เมธอดนี้ได้ก็ต่อเมื่อส่วนเสริมทำงานอยู่ในแผงด้านข้างเท่านั้น | ใช้พร็อพเพอร์ตี้ getFrameType เพื่อตรวจสอบว่าส่วนเสริมทำงานอยู่ในแผงด้านข้างหรือไม่ก่อนที่จะเรียกใช้เมธอดนี้ |
NoActivityFound |
ไม่พบกิจกรรมเมื่อดําเนินการ | ตรวจสอบว่าได้เริ่มกิจกรรมแล้วก่อนดำเนินการนี้ |
NotSupportedInMeetCall |
การโทรผ่าน Meet ไม่รองรับวิธีการนี้ | อย่าเรียกใช้เมธอดนี้ระหว่างการโทรผ่าน Meet |
NotSupportedInStandalone |
โหมดสแตนด์อโลนไม่รองรับวิธีการนี้ | อย่าเรียกใช้เมธอดนี้ในโหมดสแตนด์อโลน |
RequiresEapEnrollment |
วิธีการที่ขอต้องมีการลงทะเบียน EAP | การลงทะเบียนทดลองใช้ส่วนเสริมของ Google Meet ก่อนเปิดตัวปิดแล้ว |
SizeLimitExceededActivityStartingState |
ขนาดของ URL ActivityStartingState และ/หรือข้อมูลของ URL เกินขีดจำกัดที่อนุญาต |
ตรวจสอบว่า URL ActivityStartingState มีความยาวไม่เกิน 512 อักขระ และข้อมูลเพิ่มเติมมีความยาวไม่เกิน 4,096 อักขระ |
SizeLimitExceededAddonStartingState |
ขนาดของ URL AddonStartingState และ/หรือข้อมูลของ URL เกินขีดจำกัดที่อนุญาต |
ตรวจสอบว่า URL AddonStartingState มีความยาวไม่เกิน 512 อักขระ และข้อมูลเพิ่มเติมมีความยาวไม่เกิน 4,096 อักขระ |
SizeLimitExceededFrameToFrameMessage |
ข้อความแบบเฟรมต่อเฟรมมีขนาดเกินขีดจำกัดที่อนุญาต | ตรวจสอบว่าข้อความแบบเฟรมต่อเฟรมมีขนาดไม่เกิน 1,000,000 อักขระ |
UserCancelled |
ผู้ใช้ยกเลิกการเริ่มกิจกรรม | ผู้ใช้ต้องคลิก "ต่อไป" เพื่อเริ่มกิจกรรม |
UserNotInitiator |
ผู้ใช้ไม่ได้เป็นผู้เริ่มกิจกรรมปัจจุบัน | ตรวจสอบว่าผู้ใช้เป็นผู้เริ่มกิจกรรมปัจจุบันหรือกิจกรรมสิ้นสุดแล้ว |