คู่มือนี้จะแสดงวิธีแก้ไขข้อผิดพลาดที่เฉพาะเจาะจงของ 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 มีเฉพาะแอตทริบิวต์ต่อไปนี้ sidePanelUrl, additionalData |
ArgumentNullError |
ค่าของออบเจ็กต์ที่ระบุเป็น Null ซึ่งต้องการค่า | ตรวจสอบว่าคุณส่งค่าของประเภทที่คาดไว้สำหรับอาร์กิวเมนต์ |
ArgumentTypeError |
ประเภทของออบเจ็กต์ที่ระบุไม่ตรงกับประเภทที่คาดไว้ | ตรวจสอบว่าประเภทของอาร์กิวเมนต์ที่ระบุตรงกับประเภทที่คาดไว้ |
DestinationNotReady |
เฟรมของผู้รับไม่ได้เชื่อมต่อโดยใช้ SDK ของส่วนเสริม Meet และไม่สามารถรับการแจ้งเตือน | ตรวจสอบว่าเฟรมปลายทางเชื่อมต่ออยู่ก่อนส่งข้อความ |
InternalError |
เกิดข้อผิดพลาดภายใน Meet | ไม่มีข้อมูลเพิ่มเติม |
InvalidActivityStartingState |
ActivityStartingState URL ของ iframe ไม่ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม |
ตรวจสอบว่าต้นทางของ ActivityStartingState URL ของ 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 |
ผู้ใช้ไม่ได้เป็นผู้เริ่มกิจกรรมปัจจุบัน | ตรวจสอบว่าผู้ใช้เป็นผู้เริ่มกิจกรรมปัจจุบันหรือกิจกรรมสิ้นสุดแล้ว |