این راهنما دستورالعملهایی در مورد نحوه رفع خطاهای خاص 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 iframe مربوط به ActivityStartingState با ریشههای URLهای ارائه شده در مانیفست افزونه مطابقت داشته باشند. برای اطلاعات بیشتر، به بخش امنیت افزونه مراجعه کنید. |
InvalidAddonStartingState | آدرسهای اینترنتی iframe AddonStartingState با مبدأ آدرسهای اینترنتی ارائه شده در مانیفست افزونه مطابقت ندارند. | مطمئن شوید که مبدا URL های iframe مربوط AddonStartingState با مبدا URL های ارائه شده در مانیفست افزونه مطابقت داشته باشد. |
InvalidCloudProjectNumber | شماره پروژه ابری ارائه شده توسط Meet با شمارهای که توسط SDK افزونههای Meet وارد شده است، مطابقت ندارد. | هنگام فراخوانی ویژگی createAddonSession یا متد exposeToMeetWhenScreenSharing() ، مطمئن شوید که شماره پروژه Cloud صحیح به عنوان یک رشته به SDK ارسال شده است. این پارامتر به طور خودکار توسط Meet به هر URL iframe اضافه میشود. قبل از استفاده از مقدار ارسالی، مطمئن شوید که زیرساخت شما پارامترهای URL را تغییر نمیدهد (برای مثال، به عنوان بخشی از یک تغییر مسیر). |
MeetingPolicyPreventsStartingActivity | یک سیاست جلسه (مانند استفاده از تنظیمات کنترل میزبان) مانع از شروع فعالیت توسط کاربر میشود. | از میزبان یا مدیر جلسه بخواهید تنظیمات لازم را تغییر دهد تا به کاربر فعلی اجازه شروع فعالیت داده شود. |
MissingUrlParameter | پارامتر URL مربوط به SDK افزونههای Meet که الزامی است، موجود نیست. | این پارامتر به طور خودکار توسط Meet به URL iframe اضافه میشود. مطمئن شوید که زیرساخت شما پارامترهای URL را تغییر نمیدهد (مثلاً به عنوان بخشی از یک تغییر مسیر). |
NeedsMainStageContext | این متد فقط در صورتی قابل فراخوانی است که افزونه در مرحله اصلی در حال اجرا باشد. | قبل از فراخوانی این متد، از ویژگی getFrameType برای بررسی اینکه آیا افزونه در مرحله اصلی در حال اجرا است یا خیر، استفاده کنید. |
NeedsSidePanelContext | این روش فقط در صورتی قابل فراخوانی است که افزونه در پنل کناری در حال اجرا باشد. | قبل از فراخوانی این متد، از ویژگی getFrameType برای بررسی اینکه آیا افزونه در پنل کناری در حال اجرا است یا خیر، استفاده کنید. |
NoActivityFound | هنگام انجام عملیات، هیچ فعالیتی یافت نشد. | قبل از انجام این عملیات، مطمئن شوید که فعالیت شروع شده است. |
NotSupportedInMeetCall | این روش در تماس Meet پشتیبانی نمیشود. | این متد را در حین تماس Meet فراخوانی نکنید. |
NotSupportedInStandalone | این روش در حالت مستقل پشتیبانی نمیشود. | این متد را در حالت مستقل فراخوانی نکنید. |
RequiresEapEnrollment | روش درخواستی مستلزم ثبت نام EAP است. | ثبتنام دسترسی زودهنگام به افزونهی گوگل میت به پایان رسیده است. |
SizeLimitExceededActivityStartingState | اندازه URL های ActivityStartingState و/یا داده های آن از حد مجاز فراتر رفته است. | مطمئن شوید که اندازه URL ActivityStartingState کمتر از ۵۱۲ کاراکتر و اندازه دادههای اضافی کمتر از ۴۰۹۶ کاراکتر باشد. |
SizeLimitExceededAddonStartingState | اندازه URL های AddonStartingState و/یا دادههای آن از حد مجاز فراتر رفته است. | مطمئن شوید که اندازه URL AddonStartingState کمتر از ۵۱۲ کاراکتر و اندازه دادههای اضافی کمتر از ۴۰۹۶ کاراکتر باشد. |
SizeLimitExceededFrameToFrameMessage | اندازه پیام فریم به فریم از حد مجاز فراتر رفته است. | مطمئن شوید که اندازه پیام فریم به فریم کمتر از ۱,۰۰۰,۰۰۰ کاراکتر باشد. |
UserCancelled | کاربر شروع فعالیت را لغو کرد. | کاربر برای شروع فعالیت باید روی ادامه کلیک کند. |
UserNotInitiator | کاربر آغازگر فعالیت فعلی نیست. | مطمئن شوید که کاربر آغازگر فعالیت فعلی است یا اینکه فعالیت به پایان رسیده است. |