ปรับปรุงประสบการณ์โดยรวมของผู้ใช้โดยทำตามคำแนะนำเหล่านี้สำหรับการออกแบบส่วนเสริมของ Google Meet
แนวทางปฏิบัติแนะนำเกี่ยวกับการให้สิทธิ์
เราขอแนะนำให้ใช้แนวทางปฏิบัติแนะนำต่อไปนี้กับส่วนเสริม Google Meet ที่ต้องตรวจสอบสิทธิ์หรือให้สิทธิ์
ใช้ Google Sign-in
ผู้ใช้ส่วนมากของส่วนเสริม Google Workspace จะลงชื่อเข้าใช้ Google ไว้แล้วก่อนที่จะเข้าร่วมการประชุม ดังนั้นการมี Google One Tap เป็นตัวเลือก จะช่วยผู้ใช้ไม่ต้องเสียคลิกหลายครั้งเมื่อดำเนินการลงชื่อเข้าใช้ ดูข้อมูลเพิ่มเติมได้ที่จัดการวิธีการลงชื่อเข้าใช้สำหรับส่วนเสริม
เปิดหน้าลงชื่อเข้าใช้ของบุคคลที่สามในหน้าต่างใหม่
นอกจากการลงชื่อเข้าใช้ด้วย Google แล้ว แอปพลิเคชันของคุณอาจเสนอกลไกการลงชื่อเข้าใช้เพิ่มเติม หากเป็นเช่นนั้น ให้ใช้หน้าต่างโต้ตอบแทนการเปิดหน้าลงชื่อเข้าใช้ในแท็บใหม่ วิธีนี้จะช่วยให้ผู้ใช้ยังคงดูและกลับไปที่การโทรผ่าน Meet ได้ และจะต้องทำการคลิกโดยรวมน้อยลง
ขอขอบเขตอย่างเหมาะสมสำหรับ Google APIs
หากส่วนเสริม Meet เรียกใช้ Google API คุณต้องระบุรายการขอบเขต OAuth ทั้งหมดที่จําเป็นสําหรับส่วนเสริม ซึ่งทำได้ในหน้าการกําหนดค่าแอป Google Workspace Marketplace หลังจากเพิ่มขอบเขตเหล่านี้แล้ว ผู้ใช้จะได้รับข้อความแจ้งเมื่อติดตั้งส่วนเสริม Meet ซึ่งบอกผู้ใช้ว่ากำลังอนุญาตให้แอปของคุณเข้าถึงข้อมูลประเภทใด
คุณต้องตั้งค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะเผยแพร่ส่วนเสริมได้ ซึ่งจะต้องเพิ่มขอบเขตการให้สิทธิ์เดียวกันจากการกำหนดค่าแอป Google Workspace Marketplace การกำหนดค่าหน้าจอขอความยินยอม OAuth ยังกำหนดให้ต้องตั้งค่าข้อมูลการสร้างแบรนด์ นโยบายความเป็นส่วนตัว และข้อกำหนดในการให้บริการที่จะแสดงเมื่อมีการขอขอบเขต หากต้องการเผยแพร่ข้อมูลแบบสาธารณะ คุณต้องส่งข้อมูลทั้งหมดเพื่อรับการยืนยัน
เมื่อเขียนโค้ดเพื่อเรียกใช้ 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 แล้ว ผู้ใช้ Meet จะใช้ส่วนเสริม Google Meet ที่คุณติดตั้งใช้งานใหม่ได้ทันที ผู้ใช้จะเห็นการอัปเดตเหล่านี้ทันทีที่ล้างแคชหรือแคชหมดอายุ ดังนั้น ขอแนะนำว่าอย่าส่งการเปลี่ยนแปลงไปยังเว็บไซต์เวอร์ชันที่ใช้งานจริงจนกว่าจะทดสอบการเปลี่ยนแปลงอย่างละเอียด
เพื่อหลีกเลี่ยงการทำให้ใช้งานได้โดยตรงไปยังเวอร์ชันที่ใช้งานจริง เราขอแนะนำให้สร้างโปรเจ็กต์ Google Cloud แยกต่างหากที่เผยแพร่แบบส่วนตัวกับองค์กรของคุณ โปรเจ็กต์ที่อยู่ในระบบคลาวด์นี้จะโฮสต์ทั้งสภาพแวดล้อมการทดสอบและการพัฒนาสำหรับส่วนเสริม Meet สิทธิ์เข้าถึงโปรเจ็กต์ในระบบคลาวด์นี้ควรจำกัดไว้สำหรับทีมขนาดเล็กที่ทำงานโดยตรงในการพัฒนาส่วนเสริม
หากต้องการสร้างสภาพแวดล้อมอื่นเหล่านี้สําหรับส่วนเสริม ก่อนอื่นคุณต้องโฮสต์สภาพแวดล้อมอื่นของเว็บแอปพลิเคชันที่มีส่วนเสริมในโดเมนที่คุณเป็นเจ้าของ จากนั้นคุณสามารถสร้างสภาพแวดล้อมอื่นสำหรับส่วนเสริม Meet ได้โดยเพิ่ม การทําให้ใช้งานได้เพิ่มเติมลงในโปรเจ็กต์ Google Cloud ที่ใช้ทดสอบ การติดตั้งใช้งานใหม่เหล่านี้ควรมีไฟล์ Manifest ที่ชี้ไปยังสภาพแวดล้อมอื่นของแอปพลิเคชันเว็บ จากนั้น เราขอแนะนำให้คุณติดตั้งส่วนเสริมแต่ละรายการในสภาพแวดล้อมต่อไปนี้
- การทดสอบเวอร์ชันที่ใช้งานจริง: เผยแพร่เวอร์ชันที่ใช้งานจริงเป็นการส่วนตัวเพื่อให้ทุกคนในองค์กรช่วยทดสอบได้
- เวอร์ชันสำหรับนักพัฒนาซอฟต์แวร์: คลิกติดตั้งในคอลัมน์การดำเนินการเพื่อติดตั้งเวอร์ชันสำหรับนักพัฒนาซอฟต์แวร์ของส่วนเสริม Meet ในบัญชีของคุณเท่านั้น
เขียนการทดสอบ
ก่อนที่จะทำให้ส่วนเสริม Meet ใช้งานได้ในสภาพแวดล้อมการพัฒนา เราขอแนะนำให้เขียนการทดสอบ 1 หน่วย การทดสอบหน่วยควรมีข้อมูลต่อไปนี้
- การจำลอง SDK ของส่วนเสริม Meet แล้วตรวจสอบว่าส่วนเสริม Meet เรียกใช้ฟังก์ชัน SDK ตามที่คาดไว้
- การทดสอบหน่วยฟังก์ชันการทำงานทั้งหมดที่ไม่เกี่ยวข้องกับ SDK ของส่วนเสริมด้วยเฟรมเวิร์กการทดสอบเว็บที่ต้องการ
แนวทางปฏิบัติแนะนำเกี่ยวกับประสบการณ์ของผู้ใช้
แนวทางปฏิบัติแนะนำต่อไปนี้จะช่วยให้ส่วนเสริม Meet ใช้งานได้ง่ายขึ้นและมีประสิทธิภาพมากขึ้น
จัดการสถานะเริ่มต้นทั้งหมดในแผงด้านข้าง
เราขอแนะนำอย่างยิ่งให้ตั้งค่าส่วนเสริมตามการดำเนินการของผู้ใช้ในแผงด้านข้าง
ซึ่งทำได้โดยการตั้งค่าสถานะเริ่มต้นของกิจกรรมใน JavaScript ผู้เริ่มใช้งานส่วนเสริม (โดยทั่วไปคือผู้จัดการประชุม) ควรเป็นผู้ตั้งค่าข้อมูลทั้งหมดใน ActivityStartingState ภายในแผงด้านข้าง คุณสามารถมองว่ามุมมองแรกของแผงด้านข้างเป็นฟอร์มที่ควบคุมการตั้งค่าส่วนเสริม
ปิดแผงด้านข้างเมื่อไม่ได้ใช้งาน
หลังจากเริ่มกิจกรรมด้วยการเรียกใช้เมธอด startActivity() คุณควรเปิดแผงด้านข้างไว้เฉพาะเมื่อเป็นส่วนสำคัญในการใช้งานส่วนเสริม Google Meet ของผู้ใช้ คุณสามารถปิดแผงด้านข้างได้เมื่อเวทีหลักเปิดอยู่โดยเรียกใช้เมธอด unloadSidePanel()
โปรโมตส่วนเสริมของ Meet ผ่านการแชร์หน้าจอ
ส่วนเสริมของ Meet ให้ประสบการณ์การใช้งานที่สมบูรณ์ยิ่งขึ้นกว่าการแชร์หน้าจอ อย่างไรก็ตาม ผู้ใช้จํานวนมากคุ้นเคยกับการใช้ฟีเจอร์การแชร์หน้าจอของ Meet หากผู้ใช้แชร์แท็บที่แสดงเว็บไซต์ที่โฮสต์ส่วนเสริม Meet คุณจะกำหนดค่า Meet ให้แสดงแบนเนอร์แก่ผู้เข้าร่วมการโทรทุกคนได้โดยแจ้งให้ผู้เข้าร่วมติดตั้งหรือใช้ส่วนเสริม Meet ที่เกี่ยวข้อง ดูข้อมูลเพิ่มเติมได้ที่การโปรโมตส่วนเสริมผ่านการแชร์หน้าจอ
หลักเกณฑ์การออกแบบโลโก้
โปรดปฏิบัติตามหลักเกณฑ์ต่อไปนี้เมื่อออกแบบโลโก้สำหรับ Meet โดยเฉพาะเพื่อให้โลโก้ดูดีที่สุดในปัจจุบันและในอนาคต
ใช้รูปแบบไฟล์ PNG ขนาด 256 x 256 พิกเซล
ใช้ความโปร่งใส
ตรวจสอบว่าโลโก้ในโหมดมืดดูดีในโหมดมืดโดยใช้เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์สำหรับส่วนเสริม Meet
ปฏิบัติตามข้อกำหนดด้านกราฟิกสำหรับการผสานรวมแอปที่เฉพาะเจาะจง
อย่าใส่ระยะห่างจากขอบในรูปภาพ ขยายรูปภาพให้อยู่ภายในขอบเขตของไฟล์แทน