ใช้สถานะเริ่มต้นการทำงานร่วมกัน

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