Cải thiện trải nghiệm tổng thể của người dùng bằng cách làm theo các hướng dẫn này về thiết kế tiện ích bổ sung Google Meet.
Các phương pháp hay nhất về việc uỷ quyền
Bạn nên sử dụng các phương pháp hay nhất sau đây cho mọi tiện ích bổ sung của Google Meet yêu cầu xác thực hoặc uỷ quyền.
Sử dụng tính năng Đăng nhập bằng Google
Nhiều người dùng tiện ích bổ sung của Google Workspace sẽ đăng nhập vào Google trước khi tham gia cuộc họp. Do đó, việc cung cấp tính năng Đăng nhập bằng một lần chạm của Google có thể giúp người dùng tiết kiệm vài lượt nhấp khi thực hiện quy trình đăng nhập. Để biết thêm thông tin, hãy xem bài viết Quản lý phương thức đăng nhập cho tiện ích bổ sung.
Mở trang đăng nhập của bên thứ ba trong một cửa sổ mới
Ngoài tính năng Đăng nhập bằng Google, ứng dụng của bạn có thể cung cấp thêm các cơ chế đăng nhập. Nếu có, hãy sử dụng cửa sổ hộp thoại thay vì mở trang đăng nhập trong một thẻ mới. Bằng cách này, người dùng vẫn có thể nhìn thấy và quay lại cuộc gọi qua Meet, đồng thời sẽ thực hiện ít lượt nhấp hơn.
Yêu cầu phạm vi phù hợp cho các API của Google
Nếu tiện ích bổ sung Meet của bạn gọi các API của Google, thì bạn phải cung cấp danh sách đầy đủ các phạm vi OAuth mà tiện ích bổ sung của bạn yêu cầu. Bạn có thể thực hiện việc này trên trang Cấu hình ứng dụng Google Workspace Marketplace. Sau khi thêm các phạm vi này, người dùng sẽ thấy một lời nhắc khi họ cài đặt tiện ích bổ sung Meet của bạn. Lời nhắc này cho người dùng biết loại dữ liệu mà họ đang cho phép ứng dụng của bạn truy cập.
Trước khi xuất bản tiện ích bổ sung, bạn cũng phải thiết lập màn hình đồng ý OAuth. Bạn cần thêm chính xác các phạm vi uỷ quyền tương tự từ Cấu hình ứng dụng Google Workspace Marketplace. Việc định cấu hình màn hình xin phép bằng OAuth cũng yêu cầu bạn đặt thông tin về thương hiệu, chính sách quyền riêng tư và điều khoản dịch vụ sẽ xuất hiện khi các phạm vi được yêu cầu. Để công khai, bạn phải gửi tất cả thông tin này để xác minh.
Khi viết mã để gọi Google Workspace API, cách dễ nhất để bắt đầu là làm theo hướng dẫn Bắt đầu nhanh với JavaScript. Phương pháp này tuân thủ các phương pháp hay nhất để sử dụng tính năng Đăng nhập bằng Google và cửa sổ hộp thoại. Xin lưu ý rằng việc khởi tạo ứng dụng mã thông báo trong JavaScript yêu cầu bạn phải yêu cầu riêng các phạm vi mà ứng dụng thực sự sử dụng trong thời gian chạy. Để mang lại trải nghiệm tốt nhất cho người dùng, các phạm vi được yêu cầu này phải khớp với các phạm vi trong trang Cấu hình ứng dụng trên Google Workspace Marketplace. Tính năng dự phòng này giúp xử lý trường hợp người dùng đã thu hồi phạm vi.
Các phương pháp hay nhất để bảo trì
Các phương pháp hay nhất sau đây là để viết các ứng dụng web có thể duy trì, nhưng chúng đặc biệt quan trọng khi viết bất kỳ tiện ích bổ sung nào cho Meet.
Sử dụng phiên bản mới nhất của SDK tiện ích bổ sung của Google Meet
SDK tiện ích bổ sung của Meet được cập nhật thường xuyên. SDK tuân thủ cách tạo phiên bản ngữ nghĩa. Cách tìm phiên bản mới nhất:
- Khi sử dụng gstatic: Phiên bản SDK mới nhất có trong URL gstatic có trong hướng dẫn sử dụng SDK.
- Khi sử dụng npm: Chạy
npm update @googleworkspace/meet-add-onstrong thư mục chứapackage.jsoncho trang web lưu trữ tiện ích bổ sung Meet của bạn.
Tạo một dự án Google Cloud dàn dựng
Sau khi tiện ích bổ sung Google Meet của bạn được xuất bản trên Google Workspace Marketplace, mọi lượt triển khai mới của tiện ích bổ sung Google Meet đều có sẵn ngay lập tức cho người dùng Meet. Người dùng sẽ thấy những nội dung cập nhật này ngay khi họ xoá bộ nhớ đệm hoặc bộ nhớ đệm hết hạn. Do đó, bạn không nên đẩy các thay đổi vào trang web chính thức cho đến khi các thay đổi được kiểm thử kỹ lưỡng.
Để tránh triển khai thẳng vào quy trình sản xuất, bạn nên tạo một dự án riêng trên Google Cloud được xuất bản riêng tư cho tổ chức của mình. Dự án trên đám mây này sẽ lưu trữ cả môi trường dàn dựng và phát triển cho tiện ích bổ sung Meet của bạn. Quyền truy cập vào dự án trên Cloud này nên được giới hạn cho một nhóm nhỏ hơn đang trực tiếp tham gia phát triển tiện ích bổ sung của bạn.
Để tạo các môi trường thay thế này cho tiện ích bổ sung, trước tiên, bạn cần lưu trữ các môi trường thay thế của ứng dụng web có chứa tiện ích bổ sung trên một miền mà bạn sở hữu. Sau đó, bạn có thể tạo các môi trường thay thế cho tiện ích bổ sung Meet bằng cách thêm các lượt triển khai bổ sung vào dự án Google Cloud dàn dựng. Các hoạt động triển khai mới này phải có tệp kê khai trỏ đến các môi trường thay thế của ứng dụng web. Sau đó, bạn nên cài đặt từng môi trường bổ trợ như sau:
- Giai đoạn dàn dựng: Phát hành phiên bản dàn dựng ở chế độ riêng tư để mọi người trong tổ chức của bạn có thể hỗ trợ kiểm thử.
- Phát triển: Nhấp vào Cài đặt trong cột Thao tác để cài đặt phiên bản phát triển của tiện ích bổ sung Meet chỉ cho tài khoản của bạn.
Viết bài kiểm thử
Trước khi triển khai tiện ích bổ sung Meet vào một môi trường phát triển, bạn nên viết các kiểm thử đơn vị. Các kiểm thử đơn vị của bạn phải bao gồm:
- Mô phỏng SDK của tiện ích bổ sung Meet, sau đó xác minh rằng tiện ích bổ sung Meet gọi các hàm SDK như dự kiến.
- Kiểm thử đơn vị tất cả chức năng không liên quan đến SDK của tiện ích bổ sung bằng khung kiểm thử web mà bạn muốn.
Các phương pháp hay nhất về trải nghiệm người dùng
Các phương pháp hay nhất sau đây giúp tiện ích bổ sung Meet trở nên trực quan và tinh tế hơn.
Quản lý tất cả trạng thái ban đầu trong bảng điều khiển bên
Bạn nên thiết lập tiện ích bổ sung dựa trên các hành động của người dùng trong bảng điều khiển bên.
Bạn có thể thực hiện việc này bằng cách thiết lập trạng thái bắt đầu hoạt động trong JavaScript. Tất cả dữ liệu được đưa vào ActivityStartingState đều phải do người khởi tạo tiện ích bổ sung (thường là người tổ chức cuộc họp) đặt trong bảng điều khiển bên. Bạn có thể coi chế độ xem đầu tiên của bảng điều khiển bên là một biểu mẫu kiểm soát việc thiết lập tiện ích bổ sung.
Đóng bảng điều khiển bên khi không sử dụng
Sau khi bắt đầu hoạt động bằng cách gọi phương thức startActivity(), bạn chỉ nên giữ bảng điều khiển bên mở nếu đó là một phần thiết yếu của trải nghiệm người dùng cho tiện ích bổ sung Google Meet. Bạn có thể đóng bảng điều khiển bên sau khi giai đoạn chính mở bằng cách gọi phương thức unloadSidePanel().
Quảng bá tiện ích bổ sung Meet thông qua tính năng chia sẻ màn hình
Các tiện ích bổ sung của Meet mang lại trải nghiệm phong phú hơn so với tính năng chia sẻ màn hình. Tuy nhiên, nhiều người dùng đã quen với việc sử dụng tính năng chia sẻ màn hình của Meet. Nếu người dùng chia sẻ một thẻ hiển thị trang web lưu trữ tiện ích bổ sung Meet của bạn, thì bạn có thể định cấu hình Meet để hiển thị một biểu ngữ cho tất cả người tham gia cuộc gọi, nhắc họ cài đặt hoặc sử dụng tiện ích bổ sung Meet tương ứng. Để biết thêm thông tin, hãy xem phần quảng bá tiện ích bổ sung thông qua tính năng chia sẻ màn hình.
Nguyên tắc thiết kế biểu trưng
Hãy tuân thủ các nguyên tắc sau khi thiết kế biểu trưng dành riêng cho Meet để biểu trưng trông đẹp nhất ở hiện tại và trong tương lai:
Sử dụng định dạng tệp PNG, có kích thước 256px x 256px.
Nên sử dụng độ trong suốt.
Hãy xác minh rằng biểu trưng ở chế độ tối trông đẹp mắt khi ở chế độ tối bằng cách sử dụng công cụ dành cho nhà phát triển cho các tiện ích bổ sung của Meet.
Hãy xác minh rằng biểu trưng (và các thành phần đồ hoạ khác) trông đẹp mắt ở chế độ tương phản cao bằng cách sử dụng trình kiểm tra độ tương phản như Contrast Checker của Web Accessibility In Mind (WebAIM).
Tuân thủ các yêu cầu về đồ hoạ đối với một số trường hợp tích hợp ứng dụng cụ thể.
Không thêm khoảng đệm vào hình ảnh. Thay vào đó, hãy mở rộng hình ảnh đến ranh giới của tệp.