โปรโมตส่วนเสริมแก่ผู้ใช้ผ่านการแชร์หน้าจอ

การโปรโมตส่วนเสริม ผ่านการแชร์หน้าจอ

หน้านี้จะอธิบายวิธีโปรโมตส่วนเสริมแก่ผู้ใช้ขณะที่แชร์แท็บกับ Google Meet โดยการวางโค้ดสั้นๆ บนหน้าเว็บอื่น

เมธอด MeetAddonScreenshare.exposeToMeetWhenScreensharing ช่วยให้เว็บไซต์ส่งข้อมูลไปยัง Meet ได้เมื่อมีการแชร์หน้าจอ ข้อมูลนี้จะนำไปใช้ในการใช้งานส่วนเสริมกับ Meet เมื่อผู้ใช้คลิก "เริ่มกิจกรรม" ในแบนเนอร์งานนำเสนอหากผู้ใช้ได้ติดตั้งส่วนเสริมไว้ หากผู้ใช้ไม่ได้ติดตั้งส่วนเสริมเมื่อแชร์หน้าจอ ระบบจะแจ้งให้ติดตั้งส่วนเสริม

ออบเจ็กต์ AddonScreenshareInfo มี 5 ช่องที่คุณเพิ่มได้ตามกรณีการใช้งาน ดังนี้

  • AddonScreenshareInfo.additionalData: ข้อมูลที่ส่วนเสริมใช้เพื่อเริ่มต้นใช้งานได้ ตั้งค่าได้เฉพาะเมื่อ AddonScreenshareInfo.startActivityOnOpen เป็น "จริง" และจะเข้าถึงได้โดยใช้CollaborationStartingState ดูข้อมูลเพิ่มเติมได้ที่ใช้สถานะเริ่มต้นของการทำงานร่วมกัน

  • AddonScreenshareInfo.cloudProjectNumber: ต้องระบุ หมายเลขโปรเจ็กต์ Google Cloud ของส่วนเสริม

  • AddonScreenshareInfo.mainStageUrl: URL ที่ขั้นตอนหลักเปิดเมื่อส่วนเสริมเริ่มทำงาน เช่น https://www.example.com URL ต้องอยู่ในต้นทางเดียวกันกับ URL ที่ระบุในไฟล์ Manifest ของส่วนเสริม

  • AddonScreenshareInfo.sidePanelUrl: URL ที่แผงด้านข้างเปิดเมื่อส่วนเสริมเริ่มทำงาน เช่น https://www.example.com URL ต้องอยู่ในต้นทางเดียวกันกับ URL ที่ระบุในไฟล์ Manifest ของส่วนเสริม

  • AddonScreenshareInfo.startActivityOnOpen: ต้องระบุ เริ่มต้นประสบการณ์การใช้งานส่วนเสริมสำหรับการทำงานร่วมกันใน Meet ทันทีที่ผู้ใช้เริ่มส่วนเสริมจากแบนเนอร์งานนำเสนอหรือไม่ ต้องเป็น "จริง" หากใช้ AddonScreenshareInfo.mainStageUrl

ตัวอย่าง: โหลดในพื้นที่หลัก

ในตัวอย่างโค้ดต่อไปนี้ ผู้ใช้ที่หน้าจอแชร์หน้าจอใน Meet ที่มีรหัสต่อไปนี้จะได้รับข้อความแจ้งให้เปิดส่วนเสริม

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

แทนที่รายการต่อไปนี้

  • CLOUD_PROJECT_NUMBER: สตริง หมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของคุณ
  • MAIN_STAGE_URL: สตริง URL สำหรับเวทีหลัก

เมื่อผู้ใช้ในหน้าจอการโทรผ่าน Meet แชร์หน้าเว็บ ผู้ใช้จะเห็นแบนเนอร์งานนำเสนอใน Meet การคลิกปุ่มบนแบนเนอร์จะเป็นการเปิดส่วนเสริมสำหรับหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในขั้นตอนหลัก โหลด AddonScreenshareInfo.mainStageUrl แล้ว และใช้ AddonScreenshareInfo.additionalData เพื่อตั้งสถานะเริ่มต้นการทำงานร่วมกันของส่วนเสริม ผู้ใช้คนอื่นๆ ในสายจะได้รับข้อความแจ้งให้ติดตั้งหรือเปิดส่วนเสริมทันที

ตัวอย่าง: โหลดในแผงด้านข้าง

ในตัวอย่างโค้ดต่อไปนี้ หน้าจอผู้ใช้แชร์หน้าเว็บกับส่วนเสริมที่ต้องการเริ่มต้นในแผงด้านข้างแทนที่จะเป็นขั้นตอนหลัก

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

แทนที่รายการต่อไปนี้

  • CLOUD_PROJECT_NUMBER: สตริง หมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของคุณ
  • SIDE_PANEL_URL: สตริง URL ของแผงด้านข้าง

เมื่อผู้ใช้ในหน้าจอการโทรผ่าน Meet แชร์หน้าเว็บ ผู้ใช้จะเห็นแบนเนอร์งานนำเสนอใน Meet การคลิกปุ่มบนแบนเนอร์จะเป็นการเปิดส่วนเสริมสำหรับหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในแผงด้านข้าง โหลด AddonScreenshareInfo.sidePanelUrl แล้ว และใช้ AddonScreenshareInfo.additionalData เพื่อตั้งสถานะเริ่มต้นการทำงานร่วมกันของส่วนเสริม ผู้ใช้คนอื่นๆ ในสายจะได้รับข้อความแจ้งให้ติดตั้งหรือเปิดส่วนเสริมทันที

ตัวอย่าง: โหลดในแผงด้านข้างโดยไม่ต้องเริ่มการทำงานร่วมกัน

ในตัวอย่างโค้ดต่อไปนี้ หน้าจอของผู้ใช้แชร์หน้าเว็บกับส่วนเสริมที่ต้องปรับสิทธิ์ทรัพยากรก่อนจึงจะเริ่มกิจกรรมการทำงานร่วมกันได้ ตามข้อกำหนดนี้ ส่วนเสริมควรเริ่มต้นในแผงด้านข้างโดยไม่ต้องเริ่มการทำงานร่วมกันสำหรับทุกคน

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

แทนที่รายการต่อไปนี้

  • CLOUD_PROJECT_NUMBER: สตริง หมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของคุณ
  • SIDE_PANEL_URL: สตริง URL ของแผงด้านข้าง

เมื่อผู้ใช้ในหน้าจอการโทรผ่าน Meet แชร์หน้าเว็บ ผู้ใช้จะเห็นแบนเนอร์งานนำเสนอใน Meet การคลิกปุ่มบนแบนเนอร์จะเป็นการเปิดส่วนเสริมสำหรับหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในแผงด้านข้าง เนื่องจาก AddonScreenshareInfo.startActivityOnOpen มีการตั้งค่าเป็น "เท็จ" ปุ่มเริ่มกิจกรรมจึงปิดใช้จนกว่าจะมีการตั้งค่า CollaborationStartingState ดูข้อมูลเพิ่มเติมได้ที่ใช้สถานะเริ่มต้นการทำงานร่วมกัน

เมื่อกิจกรรมเริ่มแล้ว ผู้ใช้คนอื่นในการโทรจะได้รับข้อความแจ้งให้เปิดหรือติดตั้งส่วนเสริม

การจับคู่ต้นทาง

ต้นทางที่ระบุไว้ใน AddonScreenshareInfo.mainStageUrl และ AddonScreenshareInfo.sidePanelUrl จะเปรียบเทียบกับต้นทางในไฟล์ Manifest ของหมายเลขโปรเจ็กต์ระบบคลาวด์ที่ระบุ หากทั้งหมดตรงกัน ผู้ใช้จะได้รับอนุญาตให้เปิดส่วนเสริมได้

นอกจากนี้ ต้นทางของเว็บไซต์ที่เริ่มแชร์หน้าจอต้องแสดงในช่อง addOnOrigins ในไฟล์ไฟล์ Manifest ของส่วนเสริม

ดูข้อมูลเพิ่มเติมได้ที่ความปลอดภัยส่วนเสริม