تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يقدّم هذا الدليل نظرة عامة حول كيفية بدء استخدام إحدى إضافات Google Meet والعمل بها.
بدء إضافة من لوحة "الأنشطة"
يمكن للمستخدم النقر على زر "الأنشطة" من مكالمة Google Meet. سيؤدي ذلك إلى فتح لوحة "الأنشطة" التي تعرض قائمة بالميزات المضمّنة في Meet وأي إضافات ثبّتها المستخدم. يؤدي النقر على رمز إلى تشغيل عرض اللوحة الجانبية للإضافة.
الشكل 1. المرحلة الرئيسية واللوحة الجانبية لحزمة تطوير البرامج (SDK) لإضافات Google Meet
بعد فتح إضافة، يمكن للمستخدمين في اللوحة الجانبية بدء العمل معًا عندما تستدعي الإضافة الطريقة startActivity().
على سبيل المثال، قد تريد إحدى الإضافات السماح للمستخدمين بالتعاون في مستند، ولكنّها لا تعرف المستند المطلوب. في هذه الحالة، يجب اختيار المستند من عرض اللوحة الجانبية. بعد التأكّد من إمكانية مشاركة المستند مع الآخرين، يمكن للإضافة ضبط ActivityStartingState مع معرّفات المستندات الأخرى اللازمة.
التعاون في الشاشة الرئيسية
يمكن تنفيذ الأنشطة التعاونية في اللوحة الجانبية أو الشاشة الرئيسية. إذا تم إدراج
mainStageUrl في بيان الإضافة، سيؤدي استدعاء الطريقة
startActivity()
إلى فتح الإضافة تلقائيًا في المساحة الرئيسية
وبدء النشاط.
بعد فتح المساحة الرئيسية، يمكن للإضافة اختيار إغلاق اللوحة الجانبية من خلال استدعاء الطريقة unloadSidePanel(). لتوسيع المثال السابق، قد لا تكون اللوحة الجانبية التي تختار مستندًا مناسبة ويمكن إغلاقها.
لإعادة فتح عرض اللوحة الجانبية، يمكن للإضافة استدعاء الطريقة
loadSidePanel(). على سبيل المثال، قد يعيد فتح اللوحة الجانبية أحد الإضافات التي تنشئ استطلاعات للمستخدمين
لعرض معدّلات الردّ على الأسئلة.
بدء إضافة من خلال مشاركة الشاشة
يمكن للمستخدمين بدء الإضافات أثناء مشاركة الشاشة. إذا كان المستخدم يشارك شاشة موقع إلكتروني يتضمّن إضافة، يمكن لهذا الموقع الترويج للإضافة لدى المستخدم باستخدام الطريقة exposeToMeetWhenScreensharing(). يؤدي ذلك إلى عرض بانر إشعار للمستخدم في مكالمة Meet، يطلب منه تثبيت الإضافة أو بدء استخدامها. لمزيد من المعلومات، يُرجى الاطّلاع على الترويج لإضافة للمستخدمين من خلال مشاركة الشاشة.
بما أنّه يمكن تقديم معلومات إضافية إلى حالة بدء الإضافة من الموقع الإلكتروني الذي يشارك المستخدم شاشته، يمكن للإضافة تخطّي اللوحة الجانبية وبدء النشاط في المساحة الرئيسية مباشرةً بعد التشغيل. إذا كانت الإضافة بحاجة إلى تنفيذ خطوات إضافية، مثل تغيير الأذونات على مستند لمشاركته، يمكن للإضافة أن تفتح في اللوحة الجانبية وتتّبع المسار الموضّح في التعاون مع مستخدمين آخرين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Use a Meet add-on\n\nThis guide provides an overview of how people start and work with a\nGoogle Meet add-on.\n\nStart an add-on from the Activities panel\n-----------------------------------------\n\nFrom a Google Meet call, a user can click the Activities button. This brings\nup the Activities panel, which shows a list of built-in Meet\nfeatures and any add-ons the user has installed. Clicking on an\nicon launches the side panel view of the add-on.\n**Figure 1.** The Google Meet add-ons SDK main stage and side panel.\n\nCollaborate with other users\n----------------------------\n\nTo allow users to collaborate together, the add-on can\nset the\n[`ActivityStartingState`](/workspace/meet/add-ons/reference/websdk/addon_sdk.activitystartingstate).\nFor more information, see [Collaborate using a\nMeet add-on](/workspace/meet/add-ons/guides/collaborate-in-the-add-on).\n\nAfter opening an add-on, side panel users can start\nworking together once the add-on invokes the\n[`startActivity()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetaddonclient.startactivity)\nmethod.\n\nFor example, an add-on might want to allow users to\ncollaborate on a document, but the add-on doesn't know\nwhich document. In this case, the document should be selected from the side\npanel view. After ensuring the document can be shared with others, the\nadd-on can set `ActivityStartingState` with other\nnecessary document identifiers.\n\nCollaborate in the main stage\n-----------------------------\n\nCollaborative activities can be done in the side panel or the main stage. If a\n`mainStageUrl` is listed in the add-on manifest,\ninvoking the\n[`startActivity()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetaddonclient.startactivity)\nmethod automatically opens the add-on in the main stage\nand starts the activity.\n\nOnce the main stage is open, an add-on might choose to\nclose the side panel by calling the\n[`unloadSidePanel()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetmainstageclient.unloadsidepanel)\nmethod. To extend the earlier example, a side panel that chooses a document may\nno longer be relevant and can be closed.\n\nTo re-open the side panel view, the add-on can call the\n[`loadSidePanel()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetmainstageclient.loadsidepanel)\nmethod. For example, an add-on that creates user polls\nmight reopen the side panel to display question response rates.\n\nStart an add-on from screen sharing\n-----------------------------------\n\nUsers can start add-ons while screen sharing. If a user is screen\nsharing a website that has an add-on, that website can\npromote its add-on to the user by using the\n[`exposeToMeetWhenScreensharing()`](/workspace/meet/add-ons/reference/websdk/screenshare_api.meetaddonscreenshare.exposetomeetwhenscreensharing)\nmethod. This shows the user a notification banner in the Meet\ncall, prompting the user to either install or start the\nadd-on. For more information, see [Promote an\nadd-on to users through screen\nsharing](/workspace/meet/add-ons/guides/promote#screen_sharing).\n\nSince additional information can be supplied to the\nadd-on starting state from the website the user is\nscreen sharing, the add-on can skip the side panel and\nstart the activity in the main stage immediately after launching. If the\nadd-on needs to perform additional steps, like changing\npermissions on a document to share, the add-on can\nlaunch into the side panel and follow the flow described in [Collaborate with\nother users](#collaborate-with-other-users).\n\nRelated topics\n--------------\n\n- [Collaborate using a Meet add-on](/workspace/meet/add-ons/guides/collaborate-in-the-add-on)\n- [Promote an add-on to users through screen sharing](/workspace/meet/add-ons/guides/screen-sharing)"]]
