يقدّم هذا الدليل تعليمات حول كيفية حلّ أخطاء معيّنة في حزمة تطوير البرامج (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 |
لا تتطابق عناوين URL لإطارات ActivityStartingState iframe مع مصادر عناوين URL المقدَّمة في بيان الإضافة. |
تأكَّد من أنّ مصادر عناوين URL لإطار ActivityStartingState iframe تتطابق مع مصادر عناوين URL المقدَّمة في بيان الإضافة. لمزيد من المعلومات، يُرجى الاطّلاع على أمان الإضافات. |
InvalidAddonStartingState |
لا تتطابق عناوين URL لإطارات AddonStartingState iframe مع مصادر عناوين URL المقدَّمة في بيان الإضافة. |
تأكَّد من أنّ مصادر عناوين URL لإطار AddonStartingState iframe تتطابق مع مصادر عناوين URL المقدَّمة في بيان الإضافة. |
InvalidCloudProjectNumber |
لا يتطابق رقم المشروع على السحابة الإلكترونية الذي يوفّره Meet مع الرقم الذي تم تمريره من خلال حزمة تطوير البرامج (SDK) الخاصة بإضافات Meet. | تأكَّد من تمرير رقم مشروع Cloud الصحيح إلى حزمة SDK كسلسلة عند طلب السمة createAddonSession أو الطريقة exposeToMeetWhenScreenSharing(). يضيف Meet هذه المَعلمة تلقائيًا إلى أي عناوين URL لإطارات iframe. تأكَّد من أنّ البنية الأساسية لا تعدّل مَعلمات عناوين URL (على سبيل المثال، كجزء من عملية إعادة توجيه) قبل استخدام القيمة التي تم تمريرها. |
MeetingPolicyPreventsStartingActivity |
تمنع سياسة الاجتماع (مثل استخدام إعدادات التحكّم بالمضيف) المستخدم من بدء النشاط. | اطلب من مضيف الاجتماع أو المشرف تعديل الإعدادات اللازمة للسماح للمستخدم الحالي ببدء النشاط. |
MissingUrlParameter |
لم يتم تضمين مَعلمة عنوان URL المطلوبة لحزمة تطوير البرامج (SDK) الخاصة بإضافات Meet. | يتم إلحاق هذه المَعلمة تلقائيًا برابط عنوان URL الخاص بإطار iframe من خلال Meet. تأكَّد من أنّ بنيتك الأساسية لا تعدّل مَعلمات عناوين URL (مثلاً، كجزء من عملية إعادة توجيه). |
NeedsMainStageContext |
لا يمكن استدعاء هذه الطريقة إلا إذا كانت الإضافة تعمل في المرحلة الرئيسية. | استخدِم السمة getFrameType للتحقّق مما إذا كانت الإضافة تعمل في المرحلة الرئيسية قبل استدعاء هذه الطريقة. |
NeedsSidePanelContext |
لا يمكن استدعاء هذه الطريقة إلا إذا كانت الإضافة تعمل في اللوحة الجانبية. | استخدِم السمة getFrameType للتحقّق ممّا إذا كانت الإضافة تعمل في اللوحة الجانبية قبل استدعاء هذه الطريقة. |
NoActivityFound |
لم يتم العثور على أي نشاط عند تنفيذ عملية. | تأكَّد من بدء النشاط قبل تنفيذ هذه العملية. |
NotSupportedInMeetCall |
لا تتوفّر هذه الطريقة في مكالمة Meet. | لا تستدعِ هذه الطريقة أثناء إجراء مكالمة Meet. |
NotSupportedInStandalone |
لا تتوفّر هذه الطريقة في الوضع المستقل. | لا تستدعِ هذه الطريقة في الوضع المستقل. |
RequiresEapEnrollment |
تتطلّب الطريقة المطلوبة التسجيل في برنامج الوصول المبكر. | تم إغلاق التسجيل في برنامج استخدام إضافة Google Meet قبل إطلاقها. |
SizeLimitExceededActivityStartingState |
يتجاوز حجم عناوين URL الخاصة بملف ActivityStartingState و/أو بياناته الحدود المسموح بها. |
تأكَّد من أنّ حجم عنوان URL الخاص بـ ActivityStartingState يقلّ عن 512 حرفًا وأنّ حجم البيانات الإضافية يقلّ عن 4,096 حرفًا. |
SizeLimitExceededAddonStartingState |
يتجاوز حجم عناوين URL الخاصة بملف AddonStartingState و/أو بياناته الحدود المسموح بها. |
تأكَّد من أنّ حجم عنوان URL AddonStartingState يقلّ عن 512 حرفًا وأنّ حجم البيانات الإضافية يقلّ عن 4,096 حرفًا. |
SizeLimitExceededFrameToFrameMessage |
يتجاوز حجم الرسالة من إطار إلى آخر الحدود المسموح بها. | تأكَّد من أنّ حجم الرسالة من إطار إلى آخر يقلّ عن 1,000,000 حرف. |
UserCancelled |
ألغى المستخدم بدء النشاط. | على المستخدم النقر على "متابعة" لبدء النشاط. |
UserNotInitiator |
المستخدم ليس هو من بدأ النشاط الحالي. | تأكَّد من أنّ المستخدم هو من بدأ النشاط الحالي أو أنّ النشاط قد انتهى. |