ทำงานร่วมกันโดยใช้ส่วนเสริม 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 เนื่องจากไม่มีผู้เข้าร่วมแชร์สถานะ (สีที่เลือก) ระหว่างทำกิจกรรมในส่วนเสริมตัวอย่างนี้ แต่ผู้ใช้แต่ละคนสามารถ สถานะของตนเองได้โดยเลือกสี ซึ่งจะส่งจากเฟรมแผงด้านข้างไปยัง เฟรมหลักโดยใช้ข้อความแบบเฟรมต่อเฟรม

ข้อจำกัด