این صفحه هدف ActivityStartingState و نحوه تنظیم و بازیابی آن از Google Meet Add-ons SDK را شرح می دهد.
نمای کلی وضعیت شروع فعالیت
هنگامی که یک افزونه برای اولین بار باز می شود، iframe پانل کناری URL مشخص شده در مانیفست افزونه را بارگیری می کند. این حالت اولیه ممکن است با حالت شروعی که افزونه می خواهد از آن استفاده کند، زمانی که کاربران با استفاده از دعوت فعالیت به آن ملحق می شوند، متفاوت باشد. ActivityStartingState می‌تواند برای تعیین نشانی‌های اینترنتی iframe استفاده شود که باید هنگام پیوستن کاربران با استفاده از دعوت‌نامه فعالیت، بارگیری شوند. همچنین، ویژگی additional_data می‌تواند توسط افزونه برای ذخیره داده‌هایی که ممکن است برای مقداردهی اولیه آن نیاز داشته باشد، مورد استفاده قرار گیرد.
حالت شروع فعالیت را تنظیم و دریافت کنید
با روش های زیر می توانید وضعیت شروع فعالیت را مدیریت کنید.
تنظیم کنید
برای تنظیم یا به‌روزرسانی اطلاعات مربوط به ActivityStartingState ، از متد setActivityStartingState() استفاده کنید. افزونه می تواند وضعیت شروع را در هر زمان قبل یا در طول فعالیت تنظیم کند.
نشانی‌های اینترنتی مشخص‌شده در متد setActivityStartingState() باید به همان مبدأ تعلق داشته باشند که در مانیفست افزودنی مشخص شده است. برای اطلاعات بیشتر، امنیت افزونه را ببینید.
طول کاراکتر ویژگی sidePanelUrl ، ویژگی mainStageUrl ، و طول کاراکتر ویژگی additionalData باید با محدودیت‌های اندازه مربوطه آن‌ها مطابق با اسناد مرجع SDK باشد.
mainStageClient.setActivityStartingState({
sidePanelUrl: "https://app.example.com/sidepanel",
mainStageUrl: "https://app.example.com/mainstage",
additionalData: JSON.stringify({
// State to send to participants.
})
});
دریافت کنید
برای اطلاعات در مورد ActivityStartingState ، از متد getActivityStartingState() استفاده کنید.
const startingState = mainStageClient.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);