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

ข้อจำกัด