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

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

หน้านี้อธิบายวิธีโปรโมตส่วนเสริมให้กับผู้ใช้ขณะแชร์หน้าจอแท็บกับ 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.7.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.7.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.7.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 ของส่วนเสริมด้วย

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