يوفّر هذا الدليل تعليمات حول كيفية حلّ أخطاء محدّدة في حزمة 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 |
لا يتطابق رقم مشروع Cloud الذي تقدّمه خدمة Meet مع الرقم الذي تم تمريره من خلال حزمة تطوير البرامج (SDK) لـ Meet Add-ons. | تأكَّد من تمرير رقم مشروع 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 |
المستخدم ليس هو المُشغِّل للنشاط الحالي. | تأكَّد من أنّ المستخدم هو من بدأ النشاط الحالي أو أنّه قد انتهى. |