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

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

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

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

AddonScreenshareInfo มี 5 พร็อพเพอร์ตี้ที่สามารถเพิ่มตามกรณีการใช้งาน ได้แก่

  • additionalData: ข้อมูลที่ส่วนเสริมสามารถใช้เพื่อเริ่มต้นเอง กระป๋อง ตั้งค่าได้ก็ต่อเมื่อพร็อพเพอร์ตี้ startActivityOnOpen เป็นจริงเท่านั้น เข้าถึงโดยใช้ ActivityStartingState สำหรับข้อมูลเพิ่มเติม โปรดดู ใช้กิจกรรมโดยเริ่มต้น

  • cloudProjectNumber: ต้องระบุ หมายเลขโปรเจ็กต์ของโปรเจ็กต์ Google Cloud

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

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

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/1.0.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: สตริง หมายเลขโปรเจ็กต์ของ โปรเจ็กต์ Google Cloud
  • MAIN_STAGE_URL: สตริง URL ของเวทีหลัก

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 การคลิกปุ่มในแบนเนอร์จะเปิดส่วนเสริมสำหรับหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ระบุในแผงด้านข้าง โหลดพร็อพเพอร์ตี้ sidePanelUrl แล้ว และ ใช้พร็อพเพอร์ตี้ additionalData เพื่อตั้งค่ากิจกรรมจะเริ่มต้น ของส่วนเสริม ระบบจะแจ้งให้ผู้ใช้รายอื่นในสายติดตั้งหรือเปิดใช้งานส่วนเสริมทันที

เช่น โหลดในแผงด้านข้างโดยไม่เริ่มกิจกรรม

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

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 การคลิกปุ่มในแบนเนอร์จะเปิดส่วนเสริมสำหรับหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ระบุในแผงด้านข้าง ตั้งแต่ startActivityOnOpen ตั้งค่าคุณสมบัติเป็น "เท็จ" ปุ่มเริ่มต้นกิจกรรมจะถูกปิดใช้งานจนกว่า ตั้งค่า ActivityStartingState แล้ว ดูข้อมูลเพิ่มเติมได้ที่ใช้กิจกรรม สถานะเริ่มต้น

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

การจับคู่ตามต้นฉบับ

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

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

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