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