Cải thiện trải nghiệm người dùng trải nghiệm chung bằng cách làm theo những hướng dẫn sau về Thiết kế của 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 áp dụng các phương pháp hay nhất sau đây cho Tiện ích bổ sung của Google Meet cần phải xác thực hoặc cho phép.
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 trước đây đã đăng nhập vào Google đang tham gia cuộc họp. Do đó, việc yêu cầu Đăng nhập bằng Google có sẵn dưới dạng tùy chọn có thể lưu cho người dùng nhiều lần nhấp chuột khi quy trình đăng nhập.
Mở trang đăng nhập bên thứ ba trong cửa sổ mới
Ngoài đăng nhập bằng Google, ứng dụng của bạn có thể cung cấp tính năng đăng nhập bổ sung cơ chế cụ thể. Nếu có, hãy sử dụng cửa sổ hộp thoại thay vì mở trang đăng nhập trong . Bằng cách này, người dùng vẫn có thể xem và quay lại qua Meet và sẽ có ít lượt nhấp tổng thể hơn.
Yêu cầu đúng phạm vi cho các API của Google
Nếu Tiện ích bổ sung Meet gọi API của Google, thì bạn phải cung cấp một danh sách đầy đủ các OAuth các phạm vi theo yêu cầu của tiện ích bổ sung. Việc này được thực hiện trên Trang Cấu hình ứng dụng trên Google Workspace Marketplace. Sau khi thêm các của bạn, người dùng sẽ nhận được lời nhắc khi họ cài đặt Tiện ích bổ sung của Meet cho người dùng biết họ đang xem loại dữ liệu nào cho phép ứng dụng của bạn truy cập.
Trước khi phát hành tiện ích bổ sung, bạn cũng phải thiết lập chế độ đồng ý OAuth màn hình. Bạn phải thêm chính xác cùng phạm vi uỷ quyền từ Cấu hình ứng dụng trên Google Workspace Marketplace. Định cấu hình OAuth màn hình xin phép cũng yêu cầu bạn đặt thông tin thương hiệu, chính sách quyền riêng tư và điều khoản dịch vụ được hiển thị khi phạm vi được yêu cầu. Để xuất bản công khai, tất cả thông tin này phải được gửi cho xác minh.
Khi viết mã để gọi các API của Google Workspace, hãy tuân theo JavaScript Bắt đầu nhanh là cách dễ nhất để bắt đầu. Phương pháp này tuân thủ các phương pháp hay nhất để bằng cách 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 mã thông báo khách hàng trong JavaScript yêu cầu 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 bắt buộc này phải khớp với thông tin trong Cấu hình ứng dụng trên Google Workspace Marketplace . Việc dự phòng này cung cấp phương án dự phòng để xử lý trường hợp mà người dùng đã thu hồi các phạm vi.
Các phương pháp hay nhất về bảo trì
Các phương pháp hay nhất sau đây về cách ghi dễ bảo trì ứng dụng web nhưng chúng đặc biệt quan trọng khi viết bất kỳ Tiện ích bổ sung của Meet.
Sử dụng phiên bản mới nhất của SDK tiện ích bổ sung cho Google Meet
SDK Tiện ích bổ sung của Meet được cập nhật thường xuyên. SDK tuân thủ 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 nằm trong gstatic URL có trong hướng dẫn sử dụng SDK.
- Khi sử dụng npm: Chạy
npm update @googleworkspace/meet-add-ons
từ bên trong thư mục chứapackage.json
cho trang web lưu trữ Tiện ích bổ sung Meet.
Tạo một dự án thử nghiệm trên Google Cloud
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 hoạt động triển khai mới của Tiện ích bổ sung Google Meet đều được dành cho người dùng Meet. Người dùng sẽ thấy các nội dung cập nhật này ngay khi chúng sẽ làm trống bộ nhớ đệm hoặc bộ nhớ đệm sẽ hết hạn. Vì vậy, bạn không nên đẩy các thay đổi vào trang web sản xuất của bạn cho đến khi các thay đổi được kiểm tra kỹ lưỡng.
Để tránh việc triển khai thẳng vào phiên bản chính thức, bạn nên tạo một Dự án Google Cloud được xuất bản riêng tư cho tổ chức của bạn. Dự án Cloud này sẽ lưu trữ cả quá trình thử nghiệm và môi trường phát triển riêng cho Tiện ích bổ sung Meet. Quyền truy cập cho dự án Cloud này nên được giới hạn ở một nhóm nhỏ hơn trực tiếp phụ trách việc phát triển tiện ích bổ sung.
Để 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 chứa tiện ích bổ sung trên miền mà bạn sở hữu. Sau đó: bạn có thể tạo môi trường thay thế cho Tiện ích bổ sung Meet bằng cách thêm triển khai cho dự án Google Cloud thử nghiệm của mình. Những hoạt động triển khai mới này cần phải tệp kê khai trỏ đến môi trường thay thế của ứng dụng web. Sau đó, bạn nên cài đặt từng tiện ích bổ sung môi trường như sau:
- Thử nghiệm: Xuất bản phiên bản thử nghiệm ở chế độ riêng tư để bất cứ ai trong tổ chức của bạn đều có thể hỗ trợ thử nghiệm.
- Phát triển: Nhấp vào Cài đặt trong cột Hành động để cài đặt Phiên bản phát triển của Tiện ích bổ sung Meet chỉ dành cho tài khoản của bạn.
Viết mã kiểm thử
Trước khi triển khai Tiện ích bổ sung của Meet cho một quá trình phát triển hãy viết mã kiểm thử đơn vị. Bài kiểm thử đơn vị của bạn nên bao gồm:
- Mô phỏng SDK tiện ích bổ sung cho Meet, sau đó xác minh rằng Tiện ích bổ sung Meet gọi các chức năng 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 với khung kiểm tra web mà bạn ưa thích.
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 tạo Tiện ích bổ sung của Meet 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
Chúng tôi đặc biệt khuyến khích bạn thiết lập tiện ích bổ sung dựa trên
hành động của người dùng mà người dùng đã thực hiện 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 bắt đầu cộng tác
trạng thái ở
JavaScript. Tất cả dữ liệu chuyển vào
CollaborationStartingState
phải do người khởi tạo tiện ích bổ sung thiết lập (thường
người tổ chức cuộc họp) trong bảng điều khiển bên. Bạn có thể nghĩ đến chế độ xem đầu tiên của
bảng điều khiển bên dưới dạng 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
startCollaboration
!
bạn chỉ nên giữ lại bảng điều khiển bên
mở nếu đó là một phần thiết yếu trong trải nghiệm người dùng
Tiện ích bổ sung của Google Meet. Bạn có thể đóng bảng điều khiển bên sau khi nút chính
giai đoạn được mở bằng cách gọi
unloadSidePanel
.
Quảng bá tiện ích bổ sung của Meet thông qua tính năng chia sẻ màn hình
Tiện ích bổ sung của Meet mang đến 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 của chúng tôi. Nếu người dùng chia sẻ một thẻ hiển thị trang web lưu trữ Tiện ích bổ sung của Meet, Meet có thể được định cấu hình thành hiển thị một biểu ngữ cho tất cả những người tham gia cuộc gọi để nhắc họ cài đặt hoặc sử dụng Tiện ích bổ sung tương ứng của Meet. Để biết thêm thông tin, hãy xem quảng bá tiện ích bổ sung qua màn hình chia sẻ.