โปรโมตส่วนเสริมต่อผู้ใช้

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

แชทในสาย

ระบบจะโปรโมตส่วนเสริมของ Google Meet ให้กับผู้ใช้ในแชทในสายของ Meet โดยอัตโนมัติเมื่อข้อความมีลิงก์ที่เชื่อมโยงกับส่วนเสริม นักพัฒนาแอปไม่ต้องดำเนินการใดๆ เพื่อ โปรโมตส่วนเสริมในแชท ทีมตรวจสอบจะพิจารณาว่าลิงก์ใด ที่จะเชื่อมโยงกับส่วนเสริม โดยอิงตาม URI ของแผงด้านข้าง และต้นทางของส่วนเสริมที่ตั้งค่าไว้ภายใน ไฟล์ Manifest การติดตั้งใช้งาน

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

1. หากไม่ได้ติดตั้งส่วนเสริมไว้ การ์ดจะแจ้งให้ ผู้ใช้ติดตั้งส่วนเสริม
2. หากติดตั้งส่วนเสริมแล้ว ปุ่มจะแจ้งเตือน ให้ผู้ใช้เปิดส่วนเสริม

การแชร์หน้าจอ

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

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

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

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

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

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

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

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

ติดตั้งและนำเข้า SDK

คุณเข้าถึง SDK ได้โดยใช้ npm หรือ gstatic

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.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: สตริง หมายเลขโปรเจ็กต์ของ โปรเจ็กต์ Cloud
• SIDE_PANEL_URL: สตริง URL สำหรับแผงด้านข้าง

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

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

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

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

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

<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>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

แทนที่ค่าต่อไปนี้

• CLOUD_PROJECT_NUMBER: สตริง หมายเลขโปรเจ็กต์ของ โปรเจ็กต์ Cloud
• SIDE_PANEL_URL: สตริง URL สำหรับแผงด้านข้าง

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

การจับคู่ต้นทาง

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

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

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

หัวข้อที่เกี่ยวข้อง

• ทำงานร่วมกันโดยใช้ส่วนเสริมของ Meet
• ความปลอดภัยของส่วนเสริม