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