از حالت شروع همکاری استفاده کنید

این صفحه هدف CollaborationStartingState و نحوه تنظیم و بازیابی آن از Google Meet Add-ons SDK را شرح می دهد.

مروری بر وضعیت شروع همکاری

وقتی یک افزونه برای اولین بار باز می شود، iframe پانل کناری URL مشخص شده در مانیفست افزونه را بارگیری می کند. این حالت اولیه ممکن است با حالت شروعی که افزونه می خواهد از آن استفاده کند، زمانی که کاربران با استفاده از دعوت همکاری به آن ملحق می شوند، متفاوت باشد. CollaborationStartingState می‌تواند برای تعیین نشانی‌های اینترنتی iframe که باید هنگام ملحق شدن کاربران با استفاده از دعوت همکاری بارگیری شوند، استفاده شود. همچنین، فیلد additional_data می‌تواند توسط افزونه برای ذخیره داده‌هایی که ممکن است برای مقداردهی اولیه آن نیاز داشته باشد، مورد استفاده قرار گیرد.

وضعیت شروع همکاری را تنظیم، دریافت و پاک کنید

می توانید CollaborationStartingState با روش های زیر مدیریت کنید.

CollaborationStartingState با استفاده از روش MeetAddonClient.setCollaborationStartingState تنظیم کنید.

نشانی‌های اینترنتی مشخص‌شده در روش MeetAddonClient.setCollaborationStartingState باید به همان مبدأ تعلق داشته باشند که در مانیفست افزودنی مشخص شده است. برای اطلاعات بیشتر، امنیت افزونه را ببینید.

طول sidePanelUrl ، mainStageUrl ، و additionalData باید با محدودیت‌های اندازه مربوطه خود مطابق با اسناد مرجع SDK مطابقت داشته باشد.

    mainStageClient.setCollaborationStartingState({
        sidePanelUrl: "https://app.example.com/sidepanel",
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
        // State to send to participants.
        })
    });

CollaborationStartingState با روش MeetAddonClient.getCollaborationStartingState دریافت کنید.

    const startingState = mainStageClient.getCollaborationStartingState();
    const additionalData = JSON.parse(startingState.additionalData);

با متد MeetAddonClient.clearCollaborationStartingState ، CollaborationStartingState پاک کنید.

    mainStageClient.clearCollaborationStartingState();