Từ đám mây đến đám mây SDK Local Home
Google Home Test Suite là một ứng dụng web cho phép bạn tự kiểm thử Hành động dành cho 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 thử, 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ẻ Hành động dành cho nhà thông minh để biết thông tin. Phiên bản này của Test Suite dành riêng cho quá trình phát triển và đảm bảo chất lượng.
Các bài kiểm thử do Test Suite thực hiện bao gồm nhưng không giới hạn ở những bài kiểm thử sau:
Kiểm tra để đảm bảo bạn đã triển khai tính năng Báo cáo trạng thái và Yêu cầu đồng bộ hoá cho các thiết bị và đặc điểm của mình.
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ả Báo cáo trạng thái.
Bạn có thể khởi 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 Hành động dành cho nhà thông minh. Bộ kiểm thử yêu cầu bạn đăng nhập để có thể kiểm tra các thiết bị trong Biểu đồ Google Home và gửi lệnh trực tiếp đến Trợ lý Google.Test SuiteGoogle Home GraphGoogle Assistant
Để tự kiểm thử Hành động, 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 Project ID (Mã dự án), hãy nhập mã nhận dạng dự án cho Hành động dành cho nhà thông minh.
- Nhấp vào Next (Tiếp theo).
Định cấu hình Test Settings (Chế độ cài đặt kiểm thử):
- Nếu bạn đang chứng nhận tính năng tích hợp Cloud-to-cloud, hãy giữ nguyên giá trị mặc định Report State/Request Sync Timeout (Thời gian chờ Báo cáo trạng thái/Yêu cầu đồng bộ hoá). Tuy nhiên, đối với việc kiểm thử, bạn có thể thay đổi giá trị thời gian chờ nếu tác nhân mất nhiều thời gian hơn để báo cáo trạng thái cho Biểu đồ Home.
Nếu bạn đang chứng nhận tính năng tích hợp Cloud-to-cloud, hãy đảm bảo rằng tuỳ chọn Test Request Sync được bật. 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 Biểu đồ Home hay không. Các hành động thay đổi diễn ra thông qua tính năng tích hợp mà bạn đang kiểm thử. Tính năng 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 đặc điểm Scene, hãy chọn Test Scene trait (Kiểm thử đặc điểm Cảnh).
Nếu bạn đang chạy bộ kiểm thử cho các thiết bị Local Home, hãy chọn Supports Local Home SDK (Hỗ trợ SDK Local Home).
- Chọn Local Fulfillment (Thực hiện cục bộ) hoặc Seamless Setup (Thiết lập liền mạch).
- 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 (TRUY VẤN) cục bộ.
Thực hiện Test Run (Chạy kiểm thử) và xem kết quả:
- Nhấp vào Next (Tiếp theo) để bắt đầu chạy các bài kiểm thử. Giao diện sẽ hiển thị các thiết bị và đặc điểm đang được kiểm thử.
Xem trang Results &Submission (Kết quả và nội dung gửi):
- Sau khi hoàn tất các bài kiểm thử, 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ượng bài kiểm thử đã vượt qua và không vượt qua, cũng như điểm số cuối cùng cho biết tỷ lệ phần trăm số bài kiểm thử đã vượt qua.
Bài kiểm thử xác thực việc liên kết tài khoản
Việc 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. Bài kiểm thử xác thực việ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 việ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:
Bài kiểm thử xác thực mã truy cập
Các mã 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 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 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, thì 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 gian hết 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ời gian hết hạn. Bài kiểm thử này sẽ không thành công nếu không tìm thấy mã làm mới. |
Bài kiểm thử xác thực mã làm mới
Các 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 đúng cách các mã này để lấy mã truy cập mới.
| Mục kiểm thử | Giải thích |
|---|---|
| Mã làm mới có 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 sẽ trả về lỗi Yêu cầu không hợp lệ HTTP 400 với
{"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ã lỗi hoặc thông báo", thì trường hợp kiểm thử này
sẽ không thành công. Hãy truy cập vào trang
trao đổi mã làm mới để lấy mã truy cập để biết thêm thông tin. |
| Kiểm thử xem mã truy cập đã được cập nhật sau khi làm mới mã thông báo hay chưa. | Các mã truy cập mới sẽ được trả về để phản hồi các yêu cầu mã làm mới. Nếu máy chủ của bạn cung cấp cùng một mã truy cập, 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ẽ được hiển thị. |
| 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, thì 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 các điều kiện tranh chấp có thể làm hỏng việc liên kết tài khoản của người dùng. Bài kiểm thử sẽ không thành công nếu bạn vô hiệu hoá mã làm mới cũ trước khi mã mới được sử dụng. |
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 đề xuất để giải quyết các lỗi đó.
| Thông báo Lỗi | Cách giải quyết |
|---|---|
| API HomeGraph chưa từng được sử dụng trong dự án <_id_> này hoặc đã bị tắt | Đảm bảo rằng bạn đã bật API HomeGraph. |
| 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 rằng 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 thử 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 vượt qua 100%.
Để gửi kết quả kiểm thử và chứng nhận tính năng 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 tính năng tích hợp Cloud-to-cloud, hãy nhấp vào Submit (Gửi) trong công cụ Test Suite.
- Chuyển đến Google Home Developer Console > Cloud-to-cloud > Chứng nhận.
- Chọn tính năng tích hợp mà bạn muốn chứng nhận.
- Trong phần Documentation (Tài liệu), hãy nhập mã kết quả Test Suite của bạn.
Điền tất cả các trường bắt buộc, sau đó nhấp vào Submit (Gửi).