ปรับปรุงประสบการณ์โดยรวมของผู้ใช้ด้วยการทำตามคำแนะนำเหล่านี้สำหรับการออกแบบส่วนเสริมของ Google Meet
แนวทางปฏิบัติแนะนำในการให้สิทธิ์
เราขอแนะนำให้คุณใช้แนวทางปฏิบัติแนะนำต่อไปนี้สำหรับส่วนเสริมของ Google Meet ที่ต้องมีการตรวจสอบสิทธิ์หรือการให้สิทธิ์
ใช้ Google Sign-in
ผู้ใช้ส่วนเสริมของ Google Workspace จำนวนมากจะลงชื่อเข้าใช้ Google ไว้แล้วก่อนเข้าร่วมการประชุม ดังนั้น การมีการลงชื่อเข้าใช้ด้วย One Tap ของ Google เป็นตัวเลือกจะช่วยให้ผู้ใช้คลิกน้อยลงเมื่อทำตามขั้นตอนการลงชื่อเข้าใช้ ดูข้อมูลเพิ่มเติมได้ที่จัดการวิธีการลงชื่อเข้าใช้สำหรับส่วนเสริม
เปิดหน้าลงชื่อเข้าใช้ของบุคคลที่สามในหน้าต่างใหม่
นอกจาก Google Sign-In แล้ว แอปพลิเคชันของคุณอาจมีกลไกการลงชื่อเข้าใช้เพิ่มเติม หากเป็นเช่นนั้น ให้ใช้กล่องโต้ตอบแทนการเปิดหน้าลงชื่อเข้าใช้ใน แท็บใหม่ ด้วยวิธีนี้ ผู้ใช้จะยังคงดูและกลับไปที่ การโทรผ่าน Meet ได้ และจะคลิกโดยรวมน้อยลง
ขอขอบเขตสำหรับ Google API อย่างถูกต้อง
หากส่วนเสริม Meet เรียกใช้ Google API คุณต้องระบุรายการขอบเขต OAuth ทั้งหมด ที่ส่วนเสริมของคุณต้องการ โดยดำเนินการในหน้าการกำหนดค่าแอป Google Workspace Marketplace หลังจากเพิ่มขอบเขตเหล่านี้แล้ว ผู้ใช้จะเห็นข้อความแจ้งเมื่อติดตั้งส่วนเสริม Meet ซึ่งจะแจ้งให้ผู้ใช้ทราบว่าตนเองอนุญาตให้แอปเข้าถึงข้อมูลประเภทใด
ก่อนเผยแพร่ส่วนเสริม คุณต้องตั้งค่าหน้าจอขอความยินยอม OAuth ด้วย ซึ่งต้องเพิ่มขอบเขตการให้สิทธิ์ที่เหมือนกันทุกประการจากการกำหนดค่าแอป Google Workspace Marketplace การกำหนดค่าหน้าจอขอความยินยอม OAuth ยังต้องตั้งค่าข้อมูลการสร้างแบรนด์ นโยบายความเป็นส่วนตัว และข้อกำหนดในการให้บริการที่จะแสดงเมื่อมีการขอขอบเขต หากต้องการเผยแพร่ต่อสาธารณะ คุณต้องส่งข้อมูลทั้งหมดนี้เพื่อ รับการยืนยัน
ซึ่งแตกต่างจากส่วนเสริมทั่วไปของ Google Workspaceเมื่อเขียนโค้ดเพื่อเรียกใช้ Google Workspace API การทำตามการเริ่มต้นใช้งาน JavaScript อย่างรวดเร็ว เป็นวิธีที่ง่ายที่สุดในการเริ่มต้น แนวทางนี้เป็นไปตามแนวทางปฏิบัติแนะนำสำหรับ การใช้ Google Sign-In และหน้าต่างกล่องโต้ตอบ โปรดทราบว่าการเริ่มต้นไคลเอ็นต์โทเค็น ใน JavaScript ต้องขอขอบเขตที่แอปพลิเคชัน ใช้จริงในรันไทม์แยกกัน ขอบเขตที่ขอเหล่านี้ควรตรงกับขอบเขตในหน้าการกำหนดค่าแอป Google Workspace Marketplace เพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุด การซ้ำซ้อนนี้เป็นทางเลือกสำรองเพื่อจัดการกรณีที่ผู้ใช้เพิกถอนขอบเขต
แนวทางปฏิบัติแนะนำในการบำรุงรักษา
แนวทางปฏิบัติแนะนำต่อไปนี้มีไว้สำหรับการเขียนเว็บแอปพลิเคชันที่บำรุงรักษาได้ แต่มีความสำคัญอย่างยิ่งเมื่อเขียนส่วนเสริมของ Meet
ใช้ SDK ส่วนเสริมของ Google Meet เวอร์ชันล่าสุด
เราจะอัปเดต SDK ของส่วนเสริม Meet เป็นประจำ SDK เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย วิธีค้นหาเวอร์ชันล่าสุด
- เมื่อใช้ gstatic: SDK เวอร์ชันล่าสุดจะอยู่ใน URL ของ gstatic ที่พบในวิธีการใช้ SDK
- เมื่อใช้ npm: เรียกใช้
npm update @googleworkspace/meet-add-onsจากภายใน ไดเรกทอรีที่มีpackage.jsonสำหรับเว็บไซต์ที่โฮสต์ส่วนเสริม Meet
สร้างโปรเจ็กต์ Google Cloud สำหรับการทดสอบ
เมื่อเผยแพร่ส่วนเสริม Google Meet ใน Google Workspace Marketplace แล้ว การติดตั้งใช้งานส่วนเสริม Google Meet ใหม่จะพร้อมให้บริการแก่ผู้ใช้ Meet ทันที ผู้ใช้จะเห็นข้อมูลอัปเดตเหล่านี้ทันทีที่ ล้างแคชหรือแคชหมดอายุ ดังนั้น เราขอแนะนำไม่ให้ พุชการเปลี่ยนแปลงไปยังเว็บไซต์ที่ใช้งานจริงจนกว่าจะทดสอบการเปลี่ยนแปลงอย่างละเอียด
เราขอแนะนำให้สร้างโปรเจ็กต์ Google Cloud แยกต่างหากที่เผยแพร่แบบส่วนตัว ในองค์กรของคุณเพื่อหลีกเลี่ยงการติดตั้งใช้งานในเวอร์ชันที่ใช้งานจริงโดยตรง โปรเจ็กต์ที่อยู่ในระบบคลาวด์นี้จะโฮสต์ทั้งสภาพแวดล้อมการจัดเตรียมและ การพัฒนาสำหรับส่วนเสริม Meet สิทธิ์เข้าถึง โปรเจ็กต์ระบบคลาวด์นี้ควรจำกัดไว้สำหรับทีมขนาดเล็กที่ ทำงานเกี่ยวกับการพัฒนาส่วนเสริมของคุณโดยตรง
หากต้องการสร้างสภาพแวดล้อมสำรองเหล่านี้สำหรับส่วนเสริม คุณต้องโฮสต์สภาพแวดล้อมสำรองของเว็บแอปพลิเคชันที่มี ส่วนเสริมของคุณในโดเมนที่คุณเป็นเจ้าของก่อน จากนั้น คุณจะสร้างสภาพแวดล้อมสำรองสำหรับ ส่วนเสริม Meet ได้โดยเพิ่ม การติดตั้งใช้งาน เพิ่มเติมลงในโปรเจ็กต์ Google Cloud สำหรับการทดสอบ การติดตั้งใช้งานใหม่เหล่านี้ควรมี ไฟล์ Manifest ที่ชี้ไปยังสภาพแวดล้อมสำรองของเว็บแอปพลิเคชัน จากนั้นเราขอแนะนำให้คุณติดตั้งแต่ละส่วนเสริม ในสภาพแวดล้อมดังนี้
- การจัดเตรียม: เผยแพร่เวอร์ชันการจัดเตรียมแบบส่วนตัว เพื่อให้ทุกคนในองค์กรช่วยทดสอบได้
- การพัฒนา: คลิกติดตั้งในคอลัมน์การดำเนินการเพื่อติดตั้ง เวอร์ชันการพัฒนาของส่วนเสริม Meet ในบัญชีของคุณเท่านั้น
เขียนการทดสอบ
ก่อนที่จะติดตั้งใช้งานส่วนเสริมของ Meet ในสภาพแวดล้อมการพัฒนา เราขอแนะนำให้เขียนการทดสอบหน่วย การทดสอบหน่วยควรมีข้อมูลต่อไปนี้
- จำลอง SDK ของส่วนเสริม Meet แล้วยืนยันว่าส่วนเสริม Meet เรียกใช้ฟังก์ชัน SDK ตามที่คาดไว้
- การทดสอบหน่วยฟังก์ชันการทำงานทั้งหมดที่ไม่เกี่ยวข้องกับ SDK ของส่วนเสริมด้วยเฟรมเวิร์กการทดสอบเว็บที่คุณต้องการ
แนวทางปฏิบัติแนะนำเกี่ยวกับประสบการณ์ของผู้ใช้
แนวทางปฏิบัติแนะนำต่อไปนี้จะช่วยให้ส่วนเสริม Meet ใช้งานง่ายและมีประสิทธิภาพมากขึ้น
จัดการสถานะเริ่มต้นทั้งหมดในแผงด้านข้าง
เราขอแนะนำให้ตั้งค่าส่วนเสริมตามการดำเนินการของผู้ใช้ในแผงด้านข้าง
โดยทำได้ด้วยการตั้งค่าสถานะเริ่มต้นของกิจกรรมใน JavaScript ผู้เริ่มใช้ส่วนเสริม (โดยปกติคือผู้จัดการประชุม) ควรตั้งค่าข้อมูลทั้งหมดที่จะส่งไปยัง
ActivityStartingState
ภายในแผงด้านข้าง คุณอาจมองว่ามุมมองแรกของ
แผงด้านข้างเป็นแบบฟอร์มที่ควบคุมการตั้งค่า
ส่วนเสริม
ปิดแผงด้านข้างเมื่อไม่ได้ใช้งาน
หลังจากเริ่มกิจกรรมโดยการเรียกใช้เมธอด
startActivity()
คุณควรเปิดแผงด้านข้างไว้เฉพาะในกรณีที่เป็นส่วนสำคัญ
ของประสบการณ์ของผู้ใช้สำหรับส่วนเสริม Google Meet คุณสามารถปิดแผงด้านข้างเมื่อเวทีหลัก
เปิดอยู่ได้โดยเรียกใช้เมธอด
unloadSidePanel()
โปรโมตส่วนเสริม Meet ผ่านการแชร์หน้าจอ
ส่วนเสริมของ Meet มอบประสบการณ์ที่สมบูรณ์กว่าการแชร์หน้าจอ อย่างไรก็ตาม ผู้ใช้หลายคนคุ้นเคยกับการใช้ฟีเจอร์การแชร์หน้าจอของ Meet หากผู้ใช้แชร์แท็บที่แสดงเว็บไซต์ซึ่งโฮสต์ส่วนเสริม Meet ของคุณ คุณจะกำหนดค่า Meet ให้แสดงแบนเนอร์ต่อผู้เข้าร่วมการโทรทุกคนเพื่อแจ้งให้ติดตั้งหรือใช้ส่วนเสริม Meet ที่เกี่ยวข้องได้ ดูข้อมูลเพิ่มเติมได้ที่โปรโมตส่วนเสริมผ่านการแชร์หน้าจอ
หลักเกณฑ์การออกแบบโลโก้
ปฏิบัติตามหลักเกณฑ์ต่อไปนี้เมื่อออกแบบโลโก้สำหรับ Meet เพื่อให้โลโก้ดูดีที่สุดทั้งในปัจจุบันและอนาคต
ใช้รูปแบบไฟล์ PNG ขนาด 256 x 256 พิกเซล
ใช้ความโปร่งใส
โปรดตรวจสอบว่าโลโก้โหมดมืดดูดีในโหมดมืดโดยใช้เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์สำหรับส่วนเสริมของ Meet
ตรวจสอบว่าโลโก้ (และชิ้นงานกราฟิกอื่นๆ) ดูดีในโหมดคอนทราสต์สูงโดยใช้เครื่องมือตรวจสอบคอนทราสต์ เช่น Contrast Checker จาก Web Accessibility In Mind (WebAIM)
ปฏิบัติตามข้อกำหนดด้านกราฟิกสำหรับการผสานรวมแอปที่เฉพาะเจาะจง
อย่าใส่ระยะห่างจากขอบในรูปภาพ ขยายรูปภาพให้ถึงขอบเขตของไฟล์แทน