หน้านี้อธิบายวัตถุประสงค์ของ CollaborationStartingState รวมถึงวิธีตั้งค่าและเรียกข้อมูลจาก SDK ส่วนเสริม Google Meet
ภาพรวมของสถานะเริ่มต้นการทำงานร่วมกัน
เมื่อเปิดส่วนเสริมเป็นครั้งแรก iframe แผงด้านข้างจะโหลด URL ที่ระบุไว้ในไฟล์ Manifest ของส่วนเสริม โดยสถานะเริ่มต้นนี้อาจแตกต่างจากสถานะเริ่มต้นที่ส่วนเสริมต้องการใช้เมื่อผู้ใช้เข้าร่วมโดยใช้คำเชิญเข้าร่วมการทำงานร่วมกัน คุณสามารถใช้ CollaborationStartingState เพื่อระบุ URL ของ iframe ที่ควรโหลดเมื่อผู้ใช้เข้าร่วมโดยใช้คําเชิญให้ทำงานร่วมกัน นอกจากนี้ ส่วนเสริมยังใช้ช่อง additional_data เพื่อเก็บข้อมูลที่อาจจำเป็นต้องใช้ในการเริ่มต้นได้ด้วย
ตั้งค่า รับ และล้างสถานะเริ่มต้นการทำงานร่วมกัน
คุณจัดการ CollaborationStartingState ได้ด้วยวิธีต่อไปนี้
ตั้งค่า CollaborationStartingState โดยใช้เมธอด MeetAddonClient.setCollaborationStartingState ส่วนเสริมจะตั้งค่า CollaborationStartingState ได้ทุกเมื่อก่อนหรือระหว่างการทำงานร่วมกัน
URL ที่ระบุในเมธอด MeetAddonClient.setCollaborationStartingState ต้องเป็นของต้นทางเดียวกันกับต้นทางที่ระบุในไฟล์ Manifest ของส่วนเสริม สำหรับข้อมูลเพิ่มเติม โปรดดูการรักษาความปลอดภัยของส่วนเสริม
ความยาวของอักขระ CollaborationStartingState.sidePanelUrl, CollaborationStartingState.mainStageUrl และ CollaborationStartingState.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);
ล้าง CollaborationStartingState ด้วยเมธอด MeetAddonClient.clearCollaborationStartingState
mainStageClient.clearCollaborationStartingState();