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

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

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

  • AddonScreenshareInfo.sidePanelUrl URL ที่แผงด้านข้างจะเปิดขึ้นเมื่อส่วนเสริม เริ่มต้น เช่น https://www.example.com URL ต้องเป็นของ origin เป็น 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

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