Đám mây với đám mây Local Home SDK
Google Home Test Suite là ứng dụng web cho phép bạn tự kiểm tra Hành động nhà thông minh của mình. 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 tra.
Để 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 thi bao gồm nhưng không giới hạn ở những kiểm thử sau:
Kiểm tra xem Báo cáo trạng thái và Yêu cầu đồng bộ hóa có được triển khai cho thiết bị và đặc điểm của bạn hay không.
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:
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 phải đăng nhập để có thể kiểm tra các thiết bị trong Google Home Graph của bạn 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:
- 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 mã nhận dạng dự án cho Thao tác nhà thông minh của bạn.
- 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 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/Hết thời gian chờ đồng bộ hoá yêu cầu). Tuy nhiên, để thử nghiệm, 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.
Nếu đang chứng nhận tích hợp Cloud-to-cloud, hãy đảm bảo tùy chọn Test Request Sync được bật—trong quá trình thử nghiệm, bạn sẽ được nhắc thêm, cập nhật hoặc xóa thiết bị và kiểm tra xem danh sách thiết bị trong Home Graph có thay đổi hay không. Các hành động thay đổi diễn ra thông qua chế độ 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ý.
Nếu bạn đang sử dụng đặc điểm Scene, hãy chọn Đặc điểm cảnh thử nghiệm.
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 Thực hiện tại địa phương hoặc 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ử và xem kết quả:
- Nhấp vào Tiếp theo để bắt đầu chạy thử nghiệm. Giao diện này cho thấy các thiết bị và đặc điểm đang được kiểm thử.
Xem trang Kết quả và nội dung gửi:
- Sau khi hoàn tất các bài kiểm tra, hãy nhấp vào Tiếp theo để xem kết quả.
Kết quả kiểm tra bao gồm số bài kiểm tra đạt và không đạt, cùng điểm số cuối cùng cho biết tỷ lệ phần trăm đạt.
Kiểm tra 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. Kiểm tra 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 ra các sự cố tiềm ẩn.
Kiểm tra xác thực liên kết tài khoản bao gồm các bài kiểm tra để xác thực mã thông báo truy cập và mã thông báo làm mới:
Kiểm tra xác thực mã thông báo truy cập
Mã thông báo truy cập được trả về từ điểm cuối trao đổi mã thông báo của bạn sẽ được kiểm tra để đảm bảo chúng có định dạng hợp lệ và được trả về với mã thông báo làm mới hợp lệ.
| Các mục kiểm tra | Giải thích |
|---|---|
| Kiểm tra xem mã thông báo truy cập có định dạng JWT không | Việc liên kết Tài khoản Google không khuyến nghị sử dụng mã thông báo truy cập định dạng JWT. Nếu 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ã thông báo truy cập có thể hết hạn có mã thông báo làm mới không. | Phải cung cấp mã thông báo làm mới khi mã thông báo truy cập hết hạn. Kiểm tra này sẽ thất bại nếu không tìm thấy mã thông báo làm mới. |
Kiểm tra xác thực mã thông báo 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ã thông báo đó một cách thích hợp để 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ã thông báo 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 HTTP 400 Bad Request với {"error": "invalid_grant"} cho yêu cầu mã thông báo 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 thử nghiệm 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, 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ẽ được hiển thị. |
| Kiểm tra xem mã thông báo làm mới có bị thay đổi trong quá trình làm mới 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ã thông báo làm mới thay đổi, máy chủ của bạn chỉ nên vô hiệu hóa mã thông báo làm mới cũ sau khi mã thông báo làm mới mới được sử dụng, để ngăn chặn tình trạng chạy đua có thể làm hỏng liên kết tài khoản của người dùng. Bài kiểm tra sẽ thất bại nếu bạn vô hiệu hóa mã thông báo làm mới cũ trước khi sử dụng mã thông báo 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 |
|---|---|
| API HomeGraph chưa được sử dụng trong dự án <_id_> trước đây hoặc nó đã bị vô hiệu hóa | Đảm bảo bạn đã bật HomeGraph API. |
| Không tìm thấy thực thể đượ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 Lỗi khi nhận 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ả 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:
- Sau khi nhận được kết quả kiểm thử và bạn đã sẵn sàng chứng nhận quy trình tích hợp Cloud-to-cloud, hãy nhấp vào Gửi trong công cụ Test Suite.
- Chuyển đến phần Google Home Developer Console > Cloud-to-cloud > Chứng nhận.
- Chọn chế độ tích hợp mà bạn muốn chứng nhận.
- Trong phần Tài liệu, hãy nhập Test Suitemã nhận dạng kết quả của bạn.
Điền vào tất cả các trường bắt buộc, rồi nhấp vào Gửi.