Các phương pháp hay nhất

Cải thiện trải nghiệm chung 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ế của tiện ích bổ sung Google Meet.

Các phương pháp hay nhất về 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 Google One Tap dưới dạng một lựa chọn có thể giúp người dùng tiết kiệm một 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 khác. 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ể xem và quay lại cuộc gọi trên Meet, đồng thời sẽ thực hiện ít lượt nhấp hơn.

Yêu cầu phạm vi thích 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 lời nhắc khi cài đặt Tiện ích Meet. Lời nhắc này sẽ cho người dùng biết loại dữ liệu mà họ 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 màn hình đồng ý OAuth. Để làm việc này, bạn cần thêm chính xác các phạm vi uỷ quyền giống nhau từ Cấu hình ứng dụng Google Workspace Marketplace. Khi định cấu hình màn hình xin phép bằng OAuth, bạn cũng phải thiết lập thông tin thương hiệu, chính sách quyền riêng tư và điều khoản dịch vụ xuất hiện khi yêu cầu cấp quyền. Để 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 các API của Google Workspace, cách dễ nhất để bắt đầu là làm theo Hướng dẫn nhanh về JavaScript. Phương pháp này tuân thủ các phương pháp hay nhất để sử dụng cửa sổ Đăng nhập bằng Google và cửa sổ thoại. Xin lưu ý rằng việc khởi chạy ứng dụng mã thông báo trong JavaScript yêu cầu 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 của Google Workspace Marketplace. Tính năng dự phòng này cung cấp phương án dự phòng để 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 để viết ứng dụng web có thể bảo trì, nhưng các phương pháp này đặ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ủ 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 URL gstatic có trong hướng dẫn sử dụng SDK.
  • Khi sử dụng npm: Chạy npm update @googleworkspace/meet-add-ons trong thư mục chứa package.json cho trang web lưu trữ Tiện ích bổ sung Meet.

Tạo dự án Google Cloud thử nghiệm

Sau khi Tiện ích bổ sung của Google Meet được xuất bản trên Google Workspace Marketplace, người dùng Meet sẽ có thể sử dụng ngay mọi bản triển khai mới của Tiện ích bổ sung của Google Meet. Người dùng sẽ thấy các 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 lên trang web chính thức cho đến khi các thay đổi đó được kiểm thử 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 riêng được phát hành riêng tư cho tổ chức của bạn. Dự án trên Google Cloud này sẽ lưu trữ cả môi trường thử nghiệm và môi trường phát triển cho tiện ích bổ sung Meet. Quyền truy cập vào dự án trên Google Cloud này nên được giới hạn ở một nhóm nhỏ hơn, trực tiếp làm việc để 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 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 môi trường thay thế cho Tiện ích bổ sung Meet bằng cách thêm các lần triển khai bổ sung vào dự án Google Cloud đang thử nghiệm. Những nội dung triển khai mới này phải có các 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 môi trường tiện ích bổ sung như sau:

  • Thử nghiệm: Xuất bản phiên bản thử nghiệm ở chế độ riêng tư để bất kỳ 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 Thao tác để chỉ cài đặt phiên bản phát triển của Tiện ích Meet cho tài khoản của bạn.

Viết mã kiểm thử

Trước khi triển khai Tiện ích Meet vào môi trường phát triển, bạn nên viết mã kiểm thử đơn vị. Kiểm thử đơn vị của bạn phải bao gồm:

  • Mô phỏng SDK Tiện ích Meet, sau đó xác minh rằng Tiện ích Meet gọi các hàm SDK như mong đợi.
  • 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 của Meet trở nên trực quan và tinh tế hơn.

Quản lý tất cả trạng thái bắt đầ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 đặt trạng thái bắt đầu hoạt động trong JavaScript. Tất cả dữ liệu đi vào ActivityStartingState 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 mở bảng điều khiển bên nếu đó là một phần thiết yếu của trải nghiệm người dùng đối với 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ở ra 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

Tiện ích 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 Meet, thì bạn có thể định cấu hình Meet để hiển thị 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 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 đây khi thiết kế biểu trưng dành riêng cho Meet để biểu trưng đó trông đẹp nhất ngay từ bây giờ và trong tương lai:

Hãy sử dụng định dạng tệp PNG, có kích thước 256px x 256px.

Hãy sử dụng độ trong suốt.

Đảm bảo rằng biểu trưng ở chế độ tối của bạn trông ổn khi ở chế độ tối bằng cách sử dụng công cụ dành cho nhà phát triển dành cho Tiện ích bổ sung của Meet.

Tuân thủ các yêu cầu về đồ hoạ đối với các hoạt động 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.