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

หน้านี้จะอธิบายวิธีจัดการออบเจ็กต์ไคลเอ็นต์ที่ ส่วนเสริมจะต้องสื่อสารกับ 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()

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

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

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

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

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

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

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

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

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

ฟีเจอร์ที่ใช้ได้เฉพาะใน MeetMainStageClient ออบเจ็กต์

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

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

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

ฟีเจอร์ที่มีเฉพาะใน MeetSidePanelClient ออบเจ็กต์:

• เมธอด notifyMainStage() จะส่งข้อความไปยัง mainStage ผู้รับข้อความจะได้รับ กำลังสมัครใช้บริการ frameToFrameMessage Callback พร็อพเพอร์ตี้ในเมนูหลัก