يقدّم هذا الدليل إرشادات حول كيفية حلّ مشاكل محددة أخطاء حزمة تطوير البرامج (SDK) الخاصة بإضافات Google Meet والتي قد تواجهها أثناء إنشاء التطبيق واختباره إضافات Meet
للحصول على تفاصيل حول خطأ ما، استخدم ملف
MeetAddonError
. ويشتمل على
errorType
التي تحدد نوع الخطأ.
أنواع الأخطاء
في ما يلي أنواع الأخطاء التي تظهر عند استخدام حزمة تطوير البرامج للإضافات في Meet. خطأ، إلى جانب شرح لكيفية تفسيرها وإرشادات حول وما يجب فعله عند الحصول عليها.
| خطأ | رسالة الخطأ | الإجراء |
|---|---|---|
CoactivityIsOngoing |
لا يمكن تنفيذ عملية أثناء تنفيذ تعاون. | تأكد من أن التعاون غير مستمر. |
DestinationNotReady |
لا يتم ربط إطار المستلم باستخدام حزمة تطوير البرامج للإضافات في Meet ولا يمكنه تلقّي الإشعار. | تأكَّد من اتصال إطار الوجهة قبل إرسال الرسائل إليه. |
InvalidCloudProjectNumber |
لا يتطابق رقم المشروع على السحابة الإلكترونية الذي قدّمته من خلال Meet مع الرقم الذي تم تمريره في "حزمة تطوير البرامج للإضافات في Meet". | تأكَّد من إدخال رقم المشروع الصحيح على Google Cloud في حزمة تطوير البرامج (SDK) كسلسلة عند طلب createAddonSession أو exposeToMeetWhenScreenSharing. يضيف تطبيق Meet هذه المَعلمة تلقائيًا إلى أي عناوين URL لإطار iframe. عليك التأكّد من أنّ البنية الأساسية لا تعدّل معلَمات عناوين URL (على سبيل المثال، كجزء من عملية إعادة توجيه) قبل استخدام القيمة التي تم ضبطها. |
InvalidCollaborationStartingState |
لا تتطابق عناوين URL لإطار iframe في CollaborationStartingState مع مصادر عناوين URL المقدَّمة في بيان الإضافة. |
تأكَّد من تطابق مصادر عنوان URL لإطار iframe CollaborationStartingState مع مصادر عناوين URL المقدّمة في بيان الإضافة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الأمان الإضافي. |
MissingUrlParameter |
لم يتم توفير مَعلمة عنوان URL المطلوبة لحزمة تطوير البرامج (SDK) الخاصة بإضافات Meet. | يضيف تطبيق Meet هذه المَعلمة تلقائيًا إلى عنوان URL لإطار iframe. تأكَّد من أنّ البنية الأساسية لا تعدّل معلَمات عناوين URL (على سبيل المثال، كجزء من عملية إعادة التوجيه). |
NeedsMainStageContext |
لا يمكن استدعاء هذه الطريقة إلا إذا كانت الإضافة قيد التشغيل في المرحلة الرئيسية. | يمكنك استخدام getFrameType للتأكّد مما إذا كانت الإضافة قيد التشغيل في المرحلة الرئيسية قبل استدعاء هذه الطريقة. |
NeedsSidePanelContext |
لا يمكن استدعاء هذه الطريقة إلا إذا كانت الإضافة قيد التشغيل في اللوحة الجانبية. | يمكنك استخدام getFrameType للتأكّد مما إذا كانت الإضافة تعمل في اللوحة الجانبية قبل استدعاء هذه الطريقة. |
NotSupportedInStandalone |
هذه الطريقة غير متاحة في الوضع المستقل. | لا تطلب هذه الطريقة في الوضع المستقل. |
RequiresEapEnrollment |
لا تتوفّر هذه الميزة إلا للشركاء الذين يستخدمون هذا التطبيق قبل إطلاقه. | إيقاف استخدام هذه الميزة، لأنّ التسجيل في حزمة تطوير البرامج (SDK) للإضافات في تطبيق Meet مغلقًا في هذا المجال. |
SizeLimitExceededCollaborationStartingState |
يتجاوز حجم عناوين URL التي يبلغ عددها CollaborationStartingState و/أو بياناتها الحدود المسموح بها. |
تأكَّد من أنّ حجم عنوان URL CollaborationStartingState أقل من 512 حرفًا، وأنّ حجم البيانات أقل من 4,096 حرفًا. |
SizeLimitExceededFrameToFrameMessage |
يتجاوز حجم رسالة إطار إلى إطار الحدود المسموح بها. | تأكَّد من أنّ حجم الرسالة من إطار إلى إطار أقل من 1 ميغابايت. |
UserNotInitiator |
المستخدم لم يبدأ عملية التعاون الحالية. | تأكد من أن المستخدم هو بادئ العمل التعاوني الحالي أو أنه قد انتهى التعاون. |
InternalError |
حدث خطأ داخلي في Meet. | لا تتوفر أي معلومات إضافية. |
CollaborationStartingStateMissingAttributes |
لا تحتوي حالة بدء التعاون على أي سمات معروفة. | لا يحتوي عنصر CollaborationStartingState المقدَّم على أي سمات معروفة. |
CollaborationStartingStateEmpty |
حالة بدء التعاون فارغة. | تم توفير عنصر CollaborationStartingState، ولكنّه لا يحتوي على أي سمات. |
CollaborationStartingStateUnrecognizedAttributes |
تحتوي حالة بدء التعاون على سمات غير معروفة. | يحتوي عنصر CollaborationStartingState المقدَّم على سمات لم يتم التعرّف عليها. |