จัดการออบเจ็กต์ไคลเอ็นต์

หน้านี้อธิบายวิธีจัดการออบเจ็กต์ของไคลเอ็นต์ที่ส่วนเสริมต้องใช้เพื่อสื่อสารกับ Google Meet

ก่อนอื่น ส่วนเสริมต้องสร้างเซสชันก่อน โดยทำดังนี้

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

แทนที่ CLOUD_PROJECT_NUMBER ด้วยหมายเลขโปรเจ็กต์ของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

จากเซสชัน คุณสามารถสร้างออบเจ็กต์ของไคลเอ็นต์ได้ 2 รายการ ดังนี้

  • MeetMainStageClient สำหรับส่วนเสริมที่ทำงานในพื้นที่หลัก ซึ่งเรียกข้อมูลได้โดยใช้ await session.createMainStageClient()

  • The MeetSidePanelClient สำหรับส่วนเสริมที่ทำงานใน side panel ซึ่งเรียกข้อมูลได้โดยใช้ await session.createSidePanelClient()

คุณต้องเรียกข้อมูลออบเจ็กต์ของไคลเอ็นต์ที่ถูกต้องสำหรับพื้นที่หลักหรือแผงด้านข้าง หากเรียกข้อมูลไคลเอ็นต์ที่ไม่ถูกต้อง SDK ของส่วนเสริม Google Meet จะแสดงข้อยกเว้น หากต้องการตรวจสอบว่าส่วนเสริมทำงานใน iframe ใด (พื้นที่หลักหรือแผงด้านข้าง) ให้ใช้ getFrameType() เมธอด

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างอินสแตนซ์ออบเจ็กต์ของไคลเอ็นต์พื้นที่หลัก

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
    });
  const mainStageClient = await session.createMainStageClient();

แทนที่ CLOUD_PROJECT_NUMBER ด้วยหมายเลขโปรเจ็กต์ของโปรเจ็กต์ Cloud ของคุณ

ฟีเจอร์ที่แชร์

ฟีเจอร์บางอย่างมีให้บริการในออบเจ็กต์ MeetMainStageClient และ MeetSidePanelClient ส่วนฟีเจอร์อื่นๆ จะเฉพาะเจาะจงกับไคลเอ็นต์บางราย

ตัวอย่างเช่น ฟีเจอร์บางอย่างที่มีให้บริการในไคลเอ็นต์ทั้ง 2 รายการ ได้แก่

  • เมธอด getActivityStartingState() ที่รับข้อมูลเกี่ยวกับสถานะเริ่มต้นของ ส่วนเสริมเมื่อผู้เข้าร่วมยอมรับคำเชิญ ให้เข้าร่วมกิจกรรม
  • เมธอด getMeetingInfo() ที่รับรายละเอียดเกี่ยวกับการประชุมที่ ส่วนเสริมกำลังทำงานอยู่
  • เมธอด setActivityStartingState() ที่กำหนดสถานะเริ่มต้นของส่วนเสริม เมื่อผู้เข้าร่วมยอมรับคำเชิญให้เข้าร่วมกิจกรรม
  • ดูรายการฟีเจอร์ทั้งหมดในไคลเอ็นต์ทั้ง 2 รายการได้ที่ MeetAddonClient ออบเจ็กต์

ฟีเจอร์เฉพาะไคลเอ็นต์

ฟีเจอร์ที่มีให้บริการใน MeetMainStageClient ออบเจ็กต์เท่านั้น

  • เมธอด notifySidePanel() จะส่งข้อความไปยังแผงด้านข้าง โดยแผงด้านข้างจะรับข้อความได้ด้วยการ สมัครใช้frameToFrameMessage ฟังก์ชันเรียกกลับ

  • เมธอด loadSidePanel() จะเปิด iframe ของแผงด้านข้าง โดยระบบจะตั้งค่าแหล่งที่มาของ iframe เป็น URL ของแผงด้านข้างจากไฟล์ Manifest

  • เมธอด unloadSidePanel() จะปิด iframe ของแผงด้านข้าง ระบบจะไม่เก็บสถานะของส่วนเสริมไว้ใน Meet เมื่อมีการเรียกเมธอดนี้ ส่วนเสริมต้องเก็บสถานะของส่วนเสริมไว้ก่อนที่จะมีการเรียกเมธอดนี้

ฟีเจอร์ที่มีให้บริการใน MeetSidePanelClient ออบเจ็กต์เท่านั้น