Google Home Test Suite là một ứng dụng web cho phép bạn tự kiểm thử Hành động 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 thiết bị và đặc điểm liên kết với tài khoản của bạn. Khi hoàn tất thử nghiệm, bạn có thể xem kết quả thử nghiệm hoặc điền vào biểu mẫu gửi để gửi kết quả thử nghiệm cho Google.
Các bài kiểm thử do Test Suite thực thi bao gồm nhưng không giới hạn ở các nội dung sau:
Kiểm tra để đảm bảo rằng Trạng thái báo cáo và Yêu cầu đồng bộ hoá được triển khai cho các thiết bị và đặc điểm của bạn.
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 thiết bị đó khớp với kết quả Trạng thái báo cáo.
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 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ị và dự án Hành động dành cho nhà thông minh của bạn. 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 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 Chi tiết dự án:
- Trong trường Mã dự án, hãy nhập giá trị nhận dạng dự án cho Hành động nhà thông minh của bạn.
- Nhấp vào Tiếp theo.
Định cấu hình Cài đặt thử nghiệm:
- Nếu chứng nhận Hành động nhà thông minh của bạn, hãy giữ nguyên giá trị Trạng thái thời gian chờ yêu cầu/Thời gian hết giờ đồng bộ của yêu cầu báo cáo. 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.
Nếu xác nhận Hành động dành cho nhà thông minh của bạn, hãy đảm bảo bạn đã bật tuỳ chọn Đồ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ị đã thay đổi trong Home Graph hay chưa. Hành động thay đổi diễn ra thông qua quá trình tích hợp bạn đang kiểm thử. Nội dung tích hợp bạn kiểm thử phải luôn gắn ít nhất một thiết bị với người dùng nhân viên hỗ trợ.
Nếu bạn đang sử dụng đặc điểm Cảnh, 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ợ SDK Home mới.
- Chọn Thực hiện đơn hàng 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ử 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 thử nghiệm.
Xem trang Kết quả và gửi:
- Sau khi thử nghiệm hoàn tất, hãy nhấp vào 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, điểm số cuối cùng cho biết tỷ lệ phần trăm đạ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 kiểm tra dịch vụ OAuth để tìm các vấn đề tiềm ẩn.
Thử nghiệm xác thực liên kết tài khoản chứa các thử nghiệm để xác thực mã truy cập và mã làm mới:
Kiểm tra xác thực mã thông báo truy cập
Các mã thông báo truy cập được trả về từ điểm cuối trao đổi mã thông báo sẽ được kiểm tra để đảm bảo các mã đó có định dạng hợp lệ và được trả về với mã làm mới hợp lệ.
| 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 hay không | Việc liên kết Tài khoản Google không khuyến khích mã thông báo truy cập định dạng JWT. Nếu bạn 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 mã truy cập có thể mở rộng 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 bài kiểm tra xác thực mã thông báo
Các mã thông báo làm mới được kiểm tra để đảm bảo điểm cuối trao đổi mã thông báo của bạn được trao đổi chính xác để lấy mã truy cập mới.
| Mục kiểm tra | Giải thích |
|---|---|
| Mã làm mới 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 HTTP 400 Bad Request với
{"error": "invalid_grant"} về yêu cầu mã thông báo làm mới không hợp lệ.
Nếu nội dung phản hồi không khớp với "mã lỗi 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. Truy cập
trao đổi mã làm mới cho mã thông báo 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ề để đáp ứng các yêu cầu làm mới mã thông báo. 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ệ không. | Thời gian hết hạn của mã thông báo truy cập sẽ được hiển thị. |
| Kiểm tra xem mã thông báo làm mới đã được xoay trong quá trình làm mới hay chưa. | Chúng tôi kiểm tra xem mã thông báo làm mới có thay đổi sau khi yêu cầu mã thông báo 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 đã sử dụng mã làm mới để tránh các tình huống tương tranh có thể phá vỡ mối liên kết tài khoản của người dùng. Quy trình kiểm tra 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 thường gặp mà bạn có thể gặp phải và cách khắc phục.
| 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 đã bị vô hiệu hóa | Đả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 xem agentUserId của bạn có hợp lệ và có liên kết với dịch vụ đó hay không. |
Hãy đảm bảo bạn có quyền Lỗi tải dữ liệu mô-đun: getGetData error: Http failed response cho https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Gửi kết quả kiểm tra
Kết quả Test Suite của bạn phải vượt qua 100% bài kiểm thử trước khi gửi biểu mẫu chứng nhận. Nếu có bất kỳ đặc điểm nào cần phải 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 công cụ đó không đạt 100%.
Để gửi kết quả thử nghiệm và chứng nhận Hành động dành cho 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ả thử nghiệm và bạn đã sẵn sàng để chứng nhận Hành động dành cho nhà thông minh, hãy nhấp vào Gửi trong công cụ Test Suite.
- Nhấp vào nút TẢI XUỐNG KẾT QUẢ KIỂM TRA để truy xuất kết quả thử nghiệm của bạn.
- Nhấp vào CHUYỂN ĐẾN BIỂU MẪU NGHIÊN CỨU để 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.