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