این راهنما دستورالعمل‌هایی درباره نحوه رفع خطاهای SDK افزونه‌های Google Meet که ممکن است هنگام ساخت و آزمایش افزونه‌های Meet با آنها مواجه شوید، ارائه می‌کند.
برای دریافت جزئیات درباره یک خطا، از شی MeetAddonError استفاده کنید. حاوی ویژگی errorType است که نوع خطا را مشخص می کند.
انواع خطا
موارد زیر انواع خطاهایی هستند که هنگام بروز خطا در SDK افزونه‌های Meet ایجاد می‌شوند، به همراه توضیح در مورد نحوه تفسیر آنها و راهنمایی در مورد کارهایی که باید هنگام دریافت آنها انجام دهید.
| خطا | پیغام خطا | اقدام |
|---|---|---|
ActivityIsOngoing | در حالی که یک فعالیت در حال انجام است، نمی توان عملیات را انجام داد. | مطمئن شوید که یک فعالیت در حال انجام نیست. |
ActivityStartingStateEmpty | وضعیت شروع فعالیت خالی است. | یک شی ActivityStartingState ارائه شده است، اما حاوی هیچ ویژگی نیست. |
ActivityStartingStateMissingAttributes | وضعیت شروع فعالیت حاوی هیچ ویژگی شناخته شده ای نیست. | مطمئن شوید که شی ActivityStartingState حداقل یکی از ویژگی های زیر را داشته باشد: mainStageUrl ، sidePanelUrl ، یا additionalData . |
ActivityStartingStateUnrecognizedAttributes | وضعیت شروع فعالیت حاوی ویژگی های ناشناخته است. | مطمئن شوید که شی ActivityStartingState فقط ویژگی های زیر را دارد: mainStageUrl ، sidePanelUrl ، یا additionalData . |
AddonSessionAlreadyCreated | جلسه افزودنی قبلا ایجاد شده است. | فقط یک بار AddonSession را نمونه برداری کنید. |
AddonStartingStateMissingAttributes | حالت شروع افزونه حاوی هیچ ویژگی شناخته شده ای نیست. | مطمئن شوید که شی AddonStartingState حداقل یکی از ویژگی های زیر را داشته باشد: sidePanelUrl ، additionalData . |
AddonStartingStateUnrecognizedAttributes | حالت شروع افزونه حاوی ویژگی های ناشناخته است. | اطمینان حاصل کنید که شی AddonStartingState فقط دارای ویژگی های زیر است: sidePanelUrl ، additionalData . |
ArgumentNullError | در جایی که مقدار مورد انتظار بود، مقدار شیء ارائه شده تهی است. | مطمئن شوید که مقداری از نوع مورد انتظار را برای آرگومان ارسال می کنید. |
ArgumentTypeError | نوع شی ارائه شده با نوع مورد انتظار مطابقت نداشت. | مطمئن شوید که نوع آرگومان ارائه شده با نوع مورد انتظار مطابقت دارد. |
DestinationNotReady | قاب گیرنده با استفاده از افزونه‌های SDK Meet متصل نیست و نمی‌تواند اعلان را دریافت کند. | قبل از ارسال پیام به فریم مقصد، مطمئن شوید که قاب مقصد متصل است. |
InternalError | یک خطای داخلی Meet رخ داده است. | اطلاعات بیشتری در دسترس نیست. |
InvalidActivityStartingState | نشانی‌های اینترنتی iframe ActivityStartingState با مبدا URLهای ارائه شده در مانیفست افزودنی مطابقت ندارد. | مطمئن شوید که مبدا URL iframe ActivityStartingState با مبدا URL های ارائه شده در مانیفست افزودنی مطابقت دارد. برای اطلاعات بیشتر، امنیت افزونه را ببینید. |
InvalidAddonStartingState | URL های iframe AddonStartingState با مبدا URL های ارائه شده در مانیفست الحاقی مطابقت ندارد. | مطمئن شوید که مبدا URL iframe AddonStartingState با مبدا URL های ارائه شده در مانیفست افزودنی مطابقت دارد. |
InvalidCloudProjectNumber | شماره پروژه Cloud ارائه شده توسط Meet با شماره ارسال شده توسط SDK برافزای Meet مطابقت ندارد. | هنگام فراخوانی ویژگی createAddonSession یا متد exposeToMeetWhenScreenSharing() ، مطمئن شوید که شماره پروژه Cloud صحیح به عنوان یک رشته به SDK ارسال شده است. این پارامتر به طور خودکار توسط 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 ActivityStartingState کمتر از 512 کاراکتر و اندازه داده های اضافی کمتر از 4096 کاراکتر باشد. |
SizeLimitExceededAddonStartingState | اندازه URL های AddonStartingState و/یا داده های آن بیش از حد مجاز است. | مطمئن شوید که اندازه URL AddonStartingState کمتر از 512 کاراکتر و اندازه داده اضافی کمتر از 4096 کاراکتر باشد. |
SizeLimitExceededFrameToFrameMessage | اندازه پیام فریم به فریم بیش از حد مجاز است. | مطمئن شوید که اندازه پیام فریم به فریم کمتر از 1,000,000 کاراکتر باشد. |
UserCancelled | کاربر شروع فعالیت را لغو کرد. | کاربر برای شروع فعالیت باید روی ادامه کلیک کند. |
UserNotInitiator | کاربر آغازگر فعالیت فعلی نیست. | مطمئن شوید که کاربر آغازگر فعالیت فعلی است یا اینکه فعالیت به پایان رسیده است. |