Bộ thử nghiệm Google Home

Google Home Test Suite là một ứng dụng web cho phép bạn tự kiểm thử Thao tác nhà thông minh. Test Suite tự động tạo và chạy các trường hợp kiểm thử dựa trên các thiết bị và đặc điểm được liên kết với tài khoản của bạn. Khi hoàn tất các bài kiểm tra, bạn có thể xem kết quả kiểm thử.

Để sử dụng Test Suite và gửi kết quả kiểm thử cho Google để được chứng nhận, hãy xem trang Kiểm thử và chia sẻ các Thao tác nhà thông minh để biết thông tin. Phiên bản Test Suite này dành riêng cho mục đích phát triển và đảm bảo chất lượng.

Các kiểm thử do Test Suite thực hiện bao gồm nhưng không giới hạn ở những kiểm thử sau:

• Kiểm tra xem bạn đã triển khai Trạng thái báo cáo và Yêu cầu đồng bộ hoá cho các thiết bị và đặc điểm của mình hay chưa.

• Xác minh rằng ý định QUERY được triển khai cho thiết bị của bạn và kết quả của ý định này khớp với kết quả của Report State.

Bạn có thể chạy công cụ Test Suite bằng cách nhấp vào nút bên dưới:

Phát hành Test Suite

Tự kiểm thử Hành động

Phần sau đây mô tả cách chạy Test Suite trên thiết bị và dự án Thao tác nhà thông minh. Test Suite yêu cầu bạn đăng nhập để có thể kiểm tra các thiết bị trong Google Home Graph và gửi lệnh trực tiếp đến Google Assistant.

Để tự kiểm thử Thao tác, hãy làm theo các bước sau:

1. Trong trình duyệt web, hãy mở Test Suite.

2. Đăng nhập vào Google bằng nút ở góc trên cùng bên phải.

3. Định cấu hình Thông tin dự án:

   1. Trong trường Mã dự án, hãy nhập mã nhận dạng dự án cho Thao tác nhà thông minh của bạn.
   2. Nhấp vào Tiếp theo.

4. Định cấu hình Chế độ cài đặt kiểm thử:

   1. Nếu bạn chứng nhận việc tích hợp Cloud-to-cloud, hãy giữ nguyên giá trị mặc định Report State/Request Sync Timeout (Trạng thái báo cáo/Thời gian chờ đồng bộ hoá yêu cầu). Tuy nhiên, để kiểm thử, bạn có thể thay đổi giá trị thời gian chờ nếu tác nhân của bạn mất nhiều thời gian hơn để báo cáo trạng thái cho Home Graph.

   2. Nếu bạn chứng nhận việc tích hợp Cloud-to-cloud, hãy đảm bảo rằng bạn đã bật lựa chọn Test Request Sync (Đồng bộ hoá yêu cầu kiểm thử) – trong quá trình kiểm thử, bạn sẽ được nhắc thêm, cập nhật hoặc xoá một thiết bị và kiểm tra xem danh sách thiết bị có thay đổi trong Home Graph hay không. Các hành động thay đổi diễn ra thông qua quy trình tích hợp mà bạn đang kiểm thử. Chế độ tích hợp đang được kiểm thử của bạn phải luôn có ít nhất một thiết bị được gắn vào người dùng đại lý.

   3. Nếu bạn đang sử dụng một đặc điểm Scene, hãy chọn Đặc điểm Cảnh thử nghiệm.

   4. Nếu bạn đang chạy bộ thử nghiệm cho thiết bị Local Home, hãy chọn Supports Local Home SDK (Hỗ trợ Local Home SDK).

      1. Chọn Local Fulfillment (Thực hiện đơn hàng tại địa phương) hoặc Seamless Setup (Thiết lập liền mạch).
      2. Nhấp vào Supports Local Query (Hỗ trợ truy vấn cục bộ) nếu thiết bị có thể xử lý ý định QUERY cục bộ.

5. Thực hiện Chạy thử và xem kết quả:

   1. Nhấp vào Tiếp theo để bắt đầu chạy các bài kiểm thử. Giao diện này cho thấy các thiết bị và đặc điểm đang được kiểm thử.

6. Xem trang Kết quả và nội dung gửi:

   1. Sau khi kiểm tra xong, hãy nhấp vào Tiếp theo để xem kết quả.

Kết quả kiểm thử bao gồm số lượng kiểm thử đã đạt và không đạt, cũng như điểm số cuối cùng cho biết tỷ lệ phần trăm số lượt đạt.

Thử nghiệm xác thực liên kết tài khoản

Liên kết tài khoản đóng vai trò quan trọng trong hệ sinh thái nhà thông minh của Google. Thử nghiệm xác thực liên kết tài khoản trong Test Suite sẽ kiểm tra dịch vụ OAuth của bạn để tìm các vấn đề tiềm ẩn.

Bài kiểm thử xác thực liên kết tài khoản chứa các bài kiểm thử để xác thực mã truy cập và mã làm mới:

Thử nghiệm xác thực mã truy cập

Mã truy cập do điểm cuối trao đổi mã thông báo của bạn trả về sẽ được kiểm thử để đảm bảo chúng có định dạng hợp lệ và được trả về cùng với mã làm mới hợp lệ.

Mục kiểm thử	Giải thích
Kiểm tra xem mã truy cập có ở định dạng JWT hay không	Tính năng liên kết với Tài khoản Google không đề xuất mã truy cập ở định dạng JWT. Nếu tìm thấy định dạng JWT, cảnh báo sau sẽ xuất hiện: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
Kiểm tra xem mã truy cập có thời hạn có mã làm mới hay không.	Bạn phải cung cấp mã làm mới khi mã truy cập có thể hết hạn. Thử nghiệm này sẽ không thành công nếu không tìm thấy mã làm mới.

Thử nghiệm xác thực mã làm mới

Mã làm mới được kiểm thử để đảm bảo điểm cuối trao đổi mã thông báo của bạn trao đổi mã làm mới đúng cách để lấy mã truy cập mới.

Mục kiểm thử	Giải thích
Mã làm mới không hợp lệ, kiểm tra phản hồi của đối tác.	Máy chủ của bạn phải trả về lỗi 400 Yêu cầu không hợp lệ bằng {"error": "invalid_grant"} cho yêu cầu mã làm mới không hợp lệ. Nếu phản hồi không khớp với "mã hoặc thông báo lỗi", thì trường hợp kiểm thử này sẽ không thành công. Hãy truy cập vào trao đổi mã làm mới để lấy mã truy cập để biết thêm thông tin.
Kiểm tra xem mã thông báo truy cập đã được cập nhật sau khi làm mới mã thông báo hay chưa.	Mã thông báo truy cập mới sẽ được trả về để phản hồi các yêu cầu về mã làm mới. Nếu máy chủ của bạn cung cấp mã truy cập giống nhau, thì trường hợp kiểm thử sẽ không thành công.
Kiểm tra xem mã truy cập chưa hết hạn có còn hợp lệ hay không.	Thời gian hết hạn của mã truy cập sẽ xuất hiện.
Kiểm tra xem mã làm mới có được xoay vòng trong quá trình làm mới hay không.	Chúng tôi kiểm tra xem mã làm mới có thay đổi sau yêu cầu mã làm mới hay không. Nếu mã làm mới thay đổi, máy chủ của bạn chỉ nên vô hiệu hoá mã làm mới cũ sau khi mã làm mới mới được sử dụng, để ngăn chặn tình trạng xung đột có thể làm gián đoạn quá trình liên kết tài khoản của người dùng. Thử nghiệm sẽ thất bại nếu bạn vô hiệu hoá mã làm mới cũ trước khi sử dụng mã làm mới mới.

Thông báo lỗi

Bảng sau đây liệt kê một số thông báo lỗi phổ biến mà bạn có thể gặp phải và cách khắc phục được đề xuất.

Thông báo Lỗi	Cách giải quyết
HomeGraph API chưa từng được dùng trong dự án <_id_> trước đây hoặc đã bị vô hiệu hoá	Đảm bảo bạn đã bật HomeGraph API.
Không tìm thấy pháp nhân được yêu cầu	Kiểm tra để đảm bảo agentUserId của bạn hợp lệ và được liên kết với dịch vụ của bạn.
Đảm bảo bạn có quyền resourcemanager.projects.get đối với dự án ${your project id} và đã cấp tất cả các quyền trong màn hình xin phép. Đã xảy ra lỗi khi tải dữ liệu mô-đun: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Làm theo hướng dẫn tại phần Khắc phục sự cố về quyền IAM để đảm bảo tài khoản của bạn có quyền resourcemanager.projects.get đối với dự án. Truy cập vào trang Ứng dụng có quyền truy cập vào tài khoản của bạn để kiểm tra các quyền sau đây đối với "Bộ thử nghiệm cho nhà thông minh": Thông tin cơ bản về tài khoản Xem địa chỉ email Tài khoản Google chính của bạn Xem thông tin cá nhân của bạn, bao gồm cả mọi thông tin cá nhân mà bạn đã đăng công khai Quyền truy cập bổ sung Sử dụng Assistant: truy cập rộng rãi vào Tài khoản Google của bạn Kiểm tra và điều khiển các thiết bị nhà thông minh trong Home Graph Nếu bạn gặp lỗi về quyền, trước tiên hãy xoá quyền truy cập rồi cấp tất cả các quyền trong màn hình đồng ý khi bạn đăng nhập lại.

Gửi kết quả kiểm thử

Kết quả Test Suite của bạn phải vượt qua 100% các bài kiểm tra trước khi gửi để được chứng nhận. Nếu có bất kỳ đặc điểm nào yêu cầu kiểm thử thủ công, bạn vẫn nên chạy công cụ Test Suite và đính kèm kết quả ngay cả khi kết quả đó chưa đạt 100%.

Để gửi kết quả kiểm thử và chứng nhận việc tích hợp Cloud-to-cloud, hãy làm theo các bước sau:

1. Sau khi nhận được kết quả kiểm thử và bạn đã sẵn sàng chứng nhận chế độ tích hợp Cloud-to-cloud, hãy nhấp vào Gửi trong công cụ Test Suite.
2. Chuyển đến phần Google Home Developer Console > Cloud-to-cloud > Chứng nhận.
3. Chọn chế độ tích hợp mà bạn muốn chứng nhận.
4. Trong phần Tài liệu, hãy nhập Test Suitemã nhận dạng kết quả của bạn.

5. Điền vào tất cả các trường bắt buộc, sau đó nhấp vào Gửi.