Google Home Test Suite là một ứng dụng web cho phép bạn tự kiểm tra hành động nhà thông minh của bạn. Test Suite tự động tạo và chạy các trường hợp kiểm thử dựa trên 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 quy trình kiểm thử, bạn có thể xem phiên bản kiểm thử kết quả hoặc điền vào biểu mẫu gửi để gửi kết quả xét nghiệm cho Google.
Các chương trình kiểm thử được Test Suite thực thi bao gồm, nhưng không bao gồm giới hạn ở những điều sau:
Kiểm tra để đảm bảo Trạng thái báo cáo và Yêu cầu đồng bộ hoá được triển khai cho thiết bị và đặc điểm kỹ thuật số.
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 nó khớp với kết quả Trạng thái báo cáo.
Bạn có thể nhấp vào nút này để chạy công cụ Test Suite bên dưới:
Tự kiểm tra Hành động của bạn
Phần sau đây mô tả cách chạy Test Suite trên thiết bị của bạn và dự án Hành động trong 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 rồi gửi lệnh trực tiếp tới Google Assistant.
Để tự kiểm tra Hành động của bạn, hãy làm theo các bước sau:
- Trong trình duyệt web, hãy mở Test Suite.
Đăng nhập vào Google bằng nút ở góc trên cùng bên phải.
Định cấu hình Project Details (Thông tin chi tiết về dự án):
- Trong trường Mã dự án, hãy nhập giá trị nhận dạng dự án cho Hành động trong nhà thông minh.
- Nhấp vào Tiếp theo.
Định cấu hình Chế độ cài đặt kiểm thử:
- Nếu bạn chứng nhận Hành động nhà thông minh của mình, hãy giữ nguyên giá trị mặc định Giá trị Thời gian chờ đồng bộ hoá yêu cầu/trạng thái báo cáo không thay đổi. Tuy nhiên, đối với thử nghiệm, bạn có thể thay đổi giá trị thời gian chờ nếu nhân viên hỗ trợ của bạn mất nhiều thời gian hơn để trạng thái báo cáo cho Home Graph.
Nếu bạn chứng nhận Hành động nhà thông minh của mình, hãy nhớ Kiểm tra yêu cầu đồng bộ hoá được bật—trong quá trình thử nghiệm, bạn sẽ được nhắc thêm, cập nhật hoặc xoá một thiết bị rồi kiểm tra xem danh sách thiết bị đã thay đổi trong Biểu đồ trang chủ. Thay đổi các hành động sẽ diễn ra thông qua chế độ tích hợp kiểm thử. Quá trình tích hợp đang được kiểm thử phải luôn có ít nhất một thiết bị được đính kèm với người dùng tác nhân.
Nếu bạn đang sử dụng trait Scene, hãy chọn Tính năng của cảnh kiểm thử.
Nếu bạn đang chạy bộ thử nghiệm cho các thiết bị Local Home, hãy chọn Hỗ trợ Local Home SDK.
- Chọn Local Fulfillment (Thực hiện đơn hàng cục bộ) hoặc Seamless Setup (Thiết lập liền mạch).
- Nhấp vào Hỗ trợ truy vấn cục bộ nếu thiết bị có thể xử lý ý định QUERY cục bộ.
Thực hiện Chạy thử nghiệm và xem kết quả:
- Nhấp vào Next (Tiếp theo) để bắt đầu chạy kiểm thử. Giao diện cho thấy các thiết bị và đặc điểm đang được kiểm tra.
Xem Kết quả & Trang Bài tập đã gửi:
- Sau khi kiểm thử xong, hãy nhấp vào Next (Tiếp theo) để xem kết quả.
Kết quả kiểm thử bao gồm số lượt kiểm thử đã đạt và không đạt, kết quả cuối cùng điểm số cho biết tỷ lệ chuyền bóng.
Bài kiểm tra xác thực việc liên kết tài khoản
Liên kết tài khoản đóng vai trò vai trò quan trọng trong hệ sinh thái nhà thông minh của Google. Liên kết tài khoản kiểm tra xác thực trong Test Suite sẽ kiểm tra dịch vụ OAuth của bạn các vấn đề tiềm ẩn.
Quy trình kiểm tra xác thực việc liên kết tài khoản chứa các bài kiểm tra để 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 mà điểm cuối trao đổi mã thông báo trả về sẽ được kiểm tra để đả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 | Bạn không nên dùng mã truy cập theo định dạng JWT khi liên kết Tài khoản Google. Nếu một
Tìm thấy định dạng JWT, cảnh báo sau sẽ hiển thị:
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 để đảm bảo mã truy cập hết hạn có mã làm mới. | Bạn phải cung cấp mã làm mới khi mã truy cập đã 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. |
Làm mới kiểm tra xác thực mã thông báo
Mã làm mới được kiểm tra để đảm bảo điểm cuối trao đổi mã thông báo đúng cách đổi chúng để lấy mã truy cập mới.
| Mục kiểm thử | Giải thích |
|---|---|
| Làm mới mã thông báo có mã làm mới không hợp lệ, đang kiểm tra phản hồi của đối tác. | Máy chủ của bạn sẽ trả về lỗi Yêu cầu HTTP 400 không hợp lệ với
{"error": "invalid_grant"} đối với một 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ã lỗi hoặc thông báo", trường hợp kiểm thử này
sẽ không thành công. 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ã truy cập mới cần được trả về để làm mới mã thông báo yêu cầu. Nếu máy chủ của bạn cung cấp cùng mã truy cập, trường hợp kiểm thử này 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 mã truy cập sẽ hiển thị. |
| Kiểm tra xem mã làm mới có được xoay 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ó bị thay đổi sau khi yêu cầu mã làm mới hay không. Nếu các thay đổi về mã làm mới, thì máy chủ của bạn chỉ nên vô hiệu hoá quy trình làm mới cũ mã sau khi đã sử dụng mã làm mới mới, nhằm ngăn các tình huống tương tranh có thể phá vỡ liên kết tài khoản của người dùng. Thử nghiệm sẽ không thành công nếu bạn vô hiệu hoá mã làm mới cũ trước khi sử dụng mã 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à đề xuất để giải quyết chúng.
| Thông báo Lỗi | Cách giải quyết |
|---|---|
| API HomeGraph chưa được sử dụng trong dự án <_id_> trước hoặc nó đã bị tắt | Đảm bảo rằng 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 rằng agentUserId của bạn là hợp lệ và được liên kết với
. |
Đảm bảo bạn có quyền Lỗi khi tải dữ liệu mô-đun: lỗi getModuleData: Phản hồi lỗi HTTP cho https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Gửi kết quả thử nghiệm
Kết quả Test Suite của bạn phải vượt qua 100% kiểm thử trước khi gửi biểu mẫu chứng nhận của bạn. Nếu bạn có bất cứ đặc điểm nào cần đến 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ả không đạt 100%.
Để gửi kết quả thử nghiệm và chứng nhận Hành động nhà thông minh của bạn, hãy làm theo các bước sau:
- Sau khi nhận được kết quả kiểm tra và bạn đã sẵn sàng chứng nhận Home Action (Thao tác tại nhà), hãy nhấp vào Submit (Gửi) trong công cụ Test Suite.
- Nhấp vào nút TẢI KẾT QUẢ THỬ NGHIỆM XUỐNG để truy xuất kết quả kiểm tra của bạn.
- Nhấp vào CHUYỂN ĐẾN BIỂU MẪU ĐĂNG KÝ để gửi kết quả kiểm tra cho Google.
Điền vào tất cả các trường bắt buộc, sau đó nhấp vào Gửi.