หน้านี้อธิบายวัตถุประสงค์ของ 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();