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

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

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

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

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

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

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

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

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

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

  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 ออบเจ็กต์