แก้ปัญหาและแก้ไขข้อผิดพลาดเกี่ยวกับส่วนเสริมของ Meet

คู่มือนี้มีวิธีการแก้ไขข้อผิดพลาดที่เฉพาะเจาะจงของ SDK ส่วนเสริมของ Google Meet ที่คุณอาจพบขณะสร้างและทดสอบส่วนเสริมของ Meet

หากต้องการดูรายละเอียดเกี่ยวกับข้อผิดพลาด ให้ใช้ออบเจ็กต์ MeetAddonError โดยมีพร็อพเพอร์ตี้ errorType ซึ่งระบุประเภทข้อผิดพลาด

ประเภทของข้อผิดพลาด

ต่อไปนี้คือประเภทข้อผิดพลาดที่สร้างขึ้นเมื่อ Meet Add-ons SDK แสดงข้อผิดพลาด พร้อมคำอธิบายวิธีตีความและคำแนะนำเกี่ยวกับ สิ่งที่ต้องทำเมื่อได้รับข้อผิดพลาด

ข้อผิดพลาด ข้อความแสดงข้อผิดพลาด การดำเนินการ
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 ค่าของออบเจ็กต์ที่ระบุเป็นค่าว่างในกรณีที่คาดว่าจะมีค่า ตรวจสอบว่าคุณส่งค่าที่มีประเภทที่คาดไว้สำหรับอาร์กิวเมนต์
ArgumentTypeError ประเภทของออบเจ็กต์ที่ระบุไม่ตรงกับประเภทที่คาดไว้ ตรวจสอบว่าประเภทของอาร์กิวเมนต์ที่ระบุตรงกับประเภทที่คาดไว้
DestinationNotReady เฟรมของผู้รับไม่ได้เชื่อมต่อโดยใช้ SDK ของส่วนเสริม Meet และรับการแจ้งเตือนไม่ได้ ตรวจสอบว่าเฟรมปลายทางเชื่อมต่ออยู่ก่อนส่งข้อความไปยังเฟรมนั้น
InternalError เกิดข้อผิดพลาดภายในของ Meet ไม่มีข้อมูลเพิ่มเติม
InvalidActivityStartingState ActivityStartingState URL ของ iframe ไม่ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม ตรวจสอบว่าActivityStartingStateต้นทางของ URL ของ iframe ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม ดูข้อมูลเพิ่มเติมได้ที่ความปลอดภัยของส่วนเสริม
InvalidAddonStartingState AddonStartingState URL ของ iframe ไม่ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม ตรวจสอบว่าAddonStartingStateต้นทางของ URL ของ iframe ตรงกับต้นทางของ URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม
InvalidCloudProjectNumber หมายเลขโปรเจ็กต์ระบบคลาวด์ที่ Meet ระบุไม่ตรงกับหมายเลขที่ SDK ของส่วนเสริม Meet ส่งมา ตรวจสอบว่ามีการส่งหมายเลขโปรเจ็กต์ Cloud ที่ถูกต้องไปยัง SDK เป็นสตริงเมื่อเรียกใช้พร็อพเพอร์ตี้ createAddonSession หรือเมธอด exposeToMeetWhenScreenSharing() Meet จะผนวกพารามิเตอร์นี้เข้ากับ URL ของ iframe โดยอัตโนมัติ โปรดตรวจสอบว่าโครงสร้างพื้นฐานของคุณจะไม่แก้ไขพารามิเตอร์ของ URL (เช่น เป็นส่วนหนึ่งของการเปลี่ยนเส้นทาง) ก่อนที่จะใช้ค่าที่ส่ง
MeetingPolicyPreventsStartingActivity นโยบายการประชุม (เช่น การใช้การตั้งค่าการควบคุมของผู้จัดการประชุม) จะป้องกันไม่ให้ผู้ใช้เริ่มกิจกรรม ให้ผู้จัดการประชุมหรือผู้ดูแลระบบแก้ไขการตั้งค่าที่จำเป็นเพื่ออนุญาตให้ผู้ใช้ปัจจุบันเริ่มกิจกรรม
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 ของ ActivityStartingState มีอักขระน้อยกว่า 512 ตัว และขนาดข้อมูลเพิ่มเติมมีอักขระน้อยกว่า 4,096 ตัว
SizeLimitExceededAddonStartingState ขนาดของ URL AddonStartingState และ/หรือข้อมูลเกินขีดจำกัดที่อนุญาต ตรวจสอบว่าขนาด URL ของ AddonStartingState มีอักขระน้อยกว่า 512 ตัว และขนาดข้อมูลเพิ่มเติมมีอักขระน้อยกว่า 4,096 ตัว
SizeLimitExceededFrameToFrameMessage ขนาดของข้อความแบบเฟรมต่อเฟรมเกินขีดจำกัดที่อนุญาต ตรวจสอบว่าขนาดข้อความแบบเฟรมต่อเฟรมมีอักขระน้อยกว่า 1,000,000 ตัว
UserCancelled ผู้ใช้ยกเลิกการเริ่มกิจกรรม ผู้ใช้ต้องคลิก "ดำเนินการต่อ" เพื่อเริ่มกิจกรรม
UserNotInitiator ผู้ใช้ไม่ใช่ผู้เริ่มกิจกรรมปัจจุบัน ตรวจสอบว่าผู้ใช้เป็นผู้เริ่มกิจกรรมปัจจุบันหรือกิจกรรมสิ้นสุดแล้ว