این راهنما دستورالعمل‌هایی را درباره نحوه رفع خطاهای Google Meet Add-ons SDK ارائه می‌دهد که ممکن است هنگام ساخت و آزمایش افزونه‌های Meet با آنها مواجه شوید.
برای دریافت جزئیات درباره یک خطا، از شی MeetAddonError استفاده کنید. این شامل یک ویژگی errorType است که نوع خطا را مشخص می کند.
انواع خطا
موارد زیر انواع خطاهایی هستند که هنگام ایجاد خطا توسط Meet Add-ons SDK به همراه توضیح در مورد نحوه تفسیر آنها و راهنمایی در مورد کارهایی که باید هنگام دریافت آنها انجام دهید ارائه می شود.
| خطا | پیغام خطا | عمل |
|---|---|---|
CoactivityIsOngoing | در حالی که یک همکاری در حال انجام است، نمی توان عملیات را انجام داد. | مطمئن شوید که یک همکاری ادامه ندارد. |
DestinationNotReady | قاب گیرنده با استفاده از Meet Add-ons SDK متصل نیست و نمی تواند اعلان را دریافت کند. | قبل از ارسال پیام به فریم مقصد، مطمئن شوید که قاب مقصد متصل است. |
InvalidCloudProjectNumber | شماره پروژه Cloud ارائه شده توسط Meet با شماره ارسال شده توسط Meet Add-ons SDK مطابقت ندارد. | هنگام فراخوانی createAddonSession یا exposeToMeetWhenScreenSharing ، مطمئن شوید که شماره پروژه Cloud صحیح به عنوان رشته به SDK ارسال شده است. این پارامتر به طور خودکار توسط Meet به هر URL iframe اضافه می شود. قبل از استفاده از مقدار ارسال شده مطمئن شوید که زیرساخت شما پارامترهای URL را (مثلاً به عنوان بخشی از تغییر مسیر) تغییر نمی دهد. |
InvalidCollaborationStartingState | URL های iframe CollaborationStartingState با مبدا URL های ارائه شده در مانیفست الحاقی مطابقت ندارند. | مطمئن شوید که مبدا URL iframe CollaborationStartingState با مبدا URL های ارائه شده در مانیفست افزودنی مطابقت دارد. برای اطلاعات بیشتر، امنیت افزونه را ببینید. |
MissingUrlParameter | پارامتر URL مورد نیاز Meet Add-ons SDK وجود ندارد. | این پارامتر به طور خودکار توسط Meet به URL iframe اضافه می شود. اطمینان حاصل کنید که زیرساخت شما پارامترهای URL را تغییر نمی دهد (به عنوان مثال، به عنوان بخشی از تغییر مسیر). |
NeedsMainStageContext | این روش تنها در صورتی قابل فراخوانی است که افزونه در مرحله اصلی اجرا شود. | قبل از فراخوانی این روش، از getFrameType استفاده کنید تا بررسی کنید که آیا افزونه در مرحله اصلی اجرا می شود یا خیر. |
NeedsSidePanelContext | این روش تنها در صورتی قابل فراخوانی است که افزونه در پانل کناری در حال اجرا باشد. | قبل از فراخوانی این روش، از getFrameType استفاده کنید تا بررسی کنید که آیا افزونه در پانل کناری اجرا می شود یا خیر. |
NotSupportedInStandalone | این روش در حالت مستقل پشتیبانی نمی شود. | این روش را در حالت مستقل فراخوانی نکنید. |
RequiresEapEnrollment | این ویژگی فقط برای شرکای دسترسی زودهنگام در دسترس است. | استفاده از این ویژگی را حذف کنید، زیرا ثبت نام دسترسی زودهنگام Meet Add-ons SDK بسته شده است. |
SizeLimitExceededCollaborationStartingState | اندازه URL های collaborationStartingState و/یا داده های آن از حد مجاز فراتر می رود. | مطمئن شوید که اندازه URL CollaborationStartingState کمتر از 512 کاراکتر و اندازه داده ها کمتر از 4096 کاراکتر باشد. |
SizeLimitExceededFrameToFrameMessage | اندازه پیام فریم به فریم بیش از حد مجاز است. | مطمئن شوید که اندازه پیام فریم به فریم کمتر از 1 مگابایت باشد. |
UserNotInitiator | کاربر آغازگر همکاری فعلی نیست. | مطمئن شوید که کاربر آغازگر همکاری فعلی است یا اینکه همکاری به پایان رسیده است. |
InternalError | یک خطای داخلی Meet رخ داده است. | اطلاعات بیشتری در دسترس نیست. |