หน้านี้อธิบายวิธีโปรโมตส่วนเสริมให้กับผู้ใช้ ขณะแชร์หน้าจอแท็บกับ Google Meet ด้วยการวางโค้ดสั้นๆ บนหน้าเว็บอื่น
วิธี exposeToMeetWhenScreensharing()
ช่วยให้เว็บไซต์ส่งข้อมูลไปยัง Meet ได้เมื่อมีการแชร์หน้าจอของแท็บ ระบบจะใช้ข้อมูลนี้ในการใช้งานส่วนเสริมกับ Meet เมื่อผู้ใช้คลิก "เริ่มกิจกรรม" ในแบนเนอร์ของงานนำเสนอหากติดตั้งส่วนเสริมไว้ หากผู้ใช้ไม่มี
เมื่อผู้ใช้แชร์หน้าจอแท็บ ส่วนเสริมจะ
แจ้งให้ติดตั้งส่วนเสริม
AddonScreenshareInfo
มี 5 พร็อพเพอร์ตี้ที่สามารถเพิ่มตามกรณีการใช้งาน ได้แก่
additionalData
: ข้อมูลที่ส่วนเสริมสามารถใช้เพื่อเริ่มต้นเอง กระป๋อง ตั้งค่าได้ก็ต่อเมื่อพร็อพเพอร์ตี้startActivityOnOpen
เป็นจริงเท่านั้น เข้าถึงโดยใช้ActivityStartingState
สำหรับข้อมูลเพิ่มเติม โปรดดู ใช้กิจกรรมโดยเริ่มต้นcloudProjectNumber
: ต้องระบุ หมายเลขโปรเจ็กต์ของโปรเจ็กต์ Google CloudmainStageUrl
: 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
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ส่วนเสริม ความปลอดภัย