ทำงานร่วมกันโดยใช้ส่วนเสริม Meet

ผู้เข้าร่วมการประชุมจะทำงานร่วมกันในกิจกรรมส่วนเสริม Google Meet ได้ เมื่อกิจกรรมการทำงานร่วมกันเริ่มต้นขึ้น ผู้เข้าร่วมทุกคนในการประชุมจะได้รับการแจ้งเตือนว่ากิจกรรมดังกล่าวกำลังดำเนินอยู่

การแจ้งเตือนนี้จะปรับตามความพร้อมใช้งานและสถานะการติดตั้งของส่วนเสริม

  • หากผู้เข้าร่วมติดตั้งส่วนเสริมไว้ บุคคลดังกล่าวจะเข้าร่วมกิจกรรมได้

  • หากผู้เข้าร่วมไม่ได้ติดตั้งส่วนเสริม ระบบจะเปลี่ยนเส้นทางผู้เข้าร่วมให้ติดตั้งส่วนเสริม

  • หากส่วนเสริมไม่พร้อมใช้งานสำหรับแพลตฟอร์มของผู้เข้าร่วม: ผู้เข้าร่วมจะได้รับการแจ้งเตือนว่าไม่สามารถเข้าร่วมกิจกรรมโดยใช้อุปกรณ์ปัจจุบันได้

เมื่อผู้ใช้เข้าร่วมกิจกรรม ผู้ใช้จะโหลด iframe ของตนเองพร้อมเนื้อหาส่วนเสริมของคุณ คุณสามารถปรับแต่งได้ว่าผู้เข้าร่วมใหม่ควรเปิดกิจกรรมการทำงานร่วมกันในหน้าจอหลักหรือแผงด้านข้าง

เริ่มกิจกรรม

กิจกรรมเริ่มต้นโดยการเรียกใช้เมธอด startActivity() ซึ่งใช้อินเทอร์เฟซ ActivityStartingState

ขั้นตอนที่ 1 (ไม่บังคับ): ส่วนเสริมตั้งค่าสถานะเริ่มต้นของกิจกรรม

ActivityStartingState มีข้อมูลเกี่ยวกับสถานะเริ่มต้นของส่วนเสริมที่ใช้เมื่อผู้เข้าร่วมยอมรับคำเชิญให้เข้าร่วมกิจกรรม

ส่วนเสริมจะตั้งค่าหรืออัปเดต ActivityStartingState ได้โดยเรียกใช้เมธอด setActivityStartingState() ได้ทุกเมื่อก่อนหรือระหว่างกิจกรรม คุณสามารถละเว้นการเรียก setActivityStartingState() ได้ หากตั้งค่า ActivityStartingState ในการเรียก startActivity() ไว้โดยเฉพาะ

ขั้นตอนที่ 2: ส่วนเสริมจะเริ่มกิจกรรม

กิจกรรมจะเริ่มขึ้นเมื่อส่วนเสริมเรียกใช้วิธี startActivity() ใน MeetSidePanelClient เมธอด startActivity() จะนําออบเจ็กต์ ActivityStartingState เป็นพารามิเตอร์เพื่อให้เรียกใช้ startActivity() แทนการเรียกใช้ setActivityStartingState() ได้

เมื่อผู้ใช้เลือกเนื้อหาเสร็จแล้วและพร้อมที่จะเริ่มกิจกรรม ให้เรียกใช้เมธอด startActivity() ในส่วนเสริมดังนี้

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

เมื่อเรียกใช้เมธอด startActivity() แล้ว Meet จะดำเนินการต่อไปนี้

  • สำหรับผู้เข้าร่วมคนอื่นๆ: Meet จะแสดงการแจ้งเตือนว่ากิจกรรมกำลังดำเนินอยู่

  • สำหรับผู้เริ่มต้น: หากระบุ URL ของขั้นตอนหลักใน ActivityStartingState ไว้ Meet จะเปิดเวทีหลักโดยใช้ URL จาก ActivityStartingState

ขั้นตอนที่ 3: รับสถานะเริ่มต้นของกิจกรรม

เมื่อผู้ใช้เข้าร่วมกิจกรรม ผู้ใช้จะโหลดส่วนเสริมไปยังเวทีหลักหรือแผงด้านข้างโดยขึ้นอยู่กับ ActivityStartingState

พร็อพเพอร์ตี้ additionalData ช่วยให้คุณแชร์ข้อมูลเริ่มต้น (หรือที่เรียกว่าสถานะ) กับผู้ใช้ที่เข้าร่วมกิจกรรมได้ หลังจากเริ่มต้น MainStageClient หรือ SidePanelClient แล้ว คุณจะเรียกใช้เมธอด getActivityStartingState() เพื่อดึงข้อมูลพร็อพเพอร์ตี้ additionalData ได้

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

ขั้นตอนที่ 4 (ไม่บังคับ): แชร์สถานะส่วนเสริมในกิจกรรม

นอกจากนี้ คุณยังแชร์สถานะระหว่างผู้ใช้ขณะที่กิจกรรมดำเนินอยู่ได้ด้วย คุณแชร์สถานะได้ 2 วิธีดังนี้

  • จัดการเรื่องนี้ด้วยตนเองโดยสร้างแบ็กเอนด์การซิงค์ของคุณเอง
  • ใช้ Co-Doing API ซึ่งเป็นวิธีที่สะดวกและรวดเร็วในการแชร์ข้อมูลที่กำหนดเองระหว่างผู้ใช้

ตัวอย่าง: ส่วนเสริมภาพเคลื่อนไหวใน GitHub

ตัวอย่างส่วนเสริม"ภาพเคลื่อนไหว" ใน GitHub มีการทํางานร่วมกันในส่วนเสริม ขั้นตอนที่ 1จากคู่มือนี้จะไม่รวมอยู่ในตัวอย่าง แต่ระบบจะเรียกใช้เมธอด startActivity() (ขั้นตอนที่ 2) เมื่อผู้เริ่มใช้งานส่วนเสริมคลิกปุ่ม "เริ่มภาพเคลื่อนไหว" ในแผงด้านข้าง โดยป้อนข้อมูลสถานะเริ่มต้นด้วยสีที่ผู้ใช้เลือก หลังจากที่กิจกรรมเริ่มต้นแล้ว เวทีหลักจะดึงข้อมูลสถานะเริ่มต้นโดยการเรียกใช้เมธอด getActivityStartingState() (ขั้นตอนที่ 3) ข้ามขั้นตอนที่ 4 เนื่องจากไม่มีผู้เข้าร่วมแชร์สถานะ (สีที่เลือก) ระหว่างทำกิจกรรมในส่วนเสริมตัวอย่างนี้ อย่างไรก็ตาม ผู้ใช้แต่ละคนสามารถเปลี่ยนสถานะของตนเองได้โดยเลือกสี ซึ่งระบบจะส่งจากเฟรมแผงด้านข้างไปยังเฟรมเวทีหลักโดยใช้การรับส่งข้อความระหว่างเฟรม

ข้อจำกัด