يقدّم هذا الدليل تعليمات حول كيفية حلّ أخطاء معيّنة في حزمة تطوير البرامج (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 لإطار iframe في ActivityStartingState مع مصادر عناوين URL المقدَّمة في بيان الإضافة. |
تأكَّد من أنّ مصادر عناوين URL لإطار iframe في ActivityStartingState تتطابق مع مصادر عناوين URL المقدَّمة في بيان الإضافة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة أمان الإضافة. |
InvalidAddonStartingState |
لا تتطابق عناوين URL لإطار iframe في AddonStartingState مع مصادر عناوين URL المقدَّمة في بيان الإضافة. |
تأكَّد من أنّ مصادر عناوين URL لإطار iframe في AddonStartingState تتطابق مع مصادر عناوين URL المقدَّمة في بيان الإضافة. |
InvalidCloudProjectNumber |
لا يتطابق رقم مشروع السحابة الإلكترونية الذي يقدّمه Meet مع الرقم الذي تم تمريره في حزمة تطوير البرامج (SDK) لإضافات Meet. | تأكَّد من تمرير رقم مشروع على السحابة الإلكترونية الصحيح إلى حزمة تطوير البرامج (SDK) كسلسلة عند استدعاء السمة createAddonSession أو الطريقة exposeToMeetWhenScreenSharing(). يُلحق Meet هذه المَعلمة تلقائيًا بأي عناوين URL لإطار iframe. تأكَّد من أنّ البنية الأساسية لا تعدِّل مَعلمات عنوان URL (على سبيل المثال، كجزء من عملية إعادة التوجيه) قبل استخدام القيمة التي تم تمريرها. |
MeetingPolicyPreventsStartingActivity |
تمنع سياسة الاجتماع (مثل استخدام إعدادات التحكّم بالمضيف) المستخدِم من بدء النشاط. | اطلب من مضيف الاجتماع أو المشرف تعديل الإعدادات اللازمة للسماح للمستخدِم الحالي ببدء النشاط. |
MissingUrlParameter |
مَعلمة عنوان URL المطلوبة في حزمة تطوير البرامج (SDK) لإضافات Meet غير متوفّرة. | يُلحق Meet هذه المَعلمة تلقائيًا بعنوان URL لإطار iframe. تأكَّد من أنّ البنية الأساسية لا تعدِّل مَعلمات عنوان 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 |
المستخدِم ليس هو من بدأ النشاط الحالي. | تأكَّد من أنّ المستخدِم هو من بدأ النشاط الحالي أو أنّ النشاط قد انتهى. |