Chào mừng bạn đến với Trung tâm nhà phát triển Google Home, một điểm đến mới để tìm hiểu cách phát triển các hành động nhà thông minh. Lưu ý: Bạn sẽ tiếp tục tạo các hành động trong Bảng điều khiển Actions.

Bộ thử nghiệm Google Home

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Google Home Test Suite is a web application that allows you to self-test your smart home Action. The Test Suite automatically generates and runs test cases based on the devices and traits associated with your account. When you complete the tests, you can view the test results or fill in the submission form to submit the test results to Google.

Các chương trình kiểm thử do Test Suite thực thi bao gồm, nhưng không giới hạn ở những hoạt động sau:

  • Kiểm tra để đảm bảo bạn đã triển khai Trạng thái báo cáoYê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 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:

Bắt đầu Test Suite

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 bắt buộc bạn phải đăng nhập để có thể kiểm tra các thiết bị trong Google Home Graph and send commands directly to Google Assistant .

Để tự kiểm tra Hành động của bạn, 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 Chi tiết dự án:

    1. Trong trường Mã dự án, hãy nhập giá trị nhận dạng dự án cho Hành động dành cho nhà thông minh của bạn.
    2. Nhấp vào Tiếp theo.
  4. Định cấu hình Cài đặt thử nghiệm:

    1. Nếu bạn chứng nhận Hành động dành cho nhà thông minh, hãy giữ nguyên giá trị Báo cáo trạng thái hết thời gian đồng bộ hoá yêu cầu/Thời gian chờ. Tuy nhiên, để 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 để báo cáo trạng thái cho Biểu đồ chính.
    2. Nếu bạn chứng nhận Hành động dành cho nhà thông minh, hãy đảm bảo tuỳ chọn Đồng bộ hoá yêu cầu kiểm thử đã bật. Trong quá trình kiểm thử, bạn sẽ được nhắc thêm, cập nhật hoặc xoá thiết bị và kiểm tra xem danh sách thiết bị có thay đổi trong Biểu đồ chính 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 thử nghiệm. Quá trình tích hợp đang kiểm thử phải luôn có ít nhất một thiết bị được đính kèm vào người dùng nhân viên hỗ trợ.

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

    4. Nếu bạn đang chạy bộ thử nghiệm cho các thiết bị Home Home, hãy chọn Hỗ trợ SDK cục bộ cho nhà riêng.

      1. Chọn Thực hiện cục bộ hoặc Thiết lập liền mạch.
      2. Nhấp vào Hỗ trợ truy vấn cục bộ nếu thiết bị có thể xử lý cục bộ ý định QUERY.
  5. Thực hiện Chạy thử nghiệm và xem kết quả:

    1. Nhấp vào Next (Tiếp theo) để bắt đầu chạy kiểm thử. Giao diện này cho biết các thiết bị và đặc điểm đang được kiểm thử.
  6. Xem trang Kết quả và gửi:

    1. Sau khi thử nghiệm 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ượ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 số lượt vượt qua.

Thử nghiệm 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. Thử nghiệm 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 để phát hiện các vấn đề tiềm ẩn.

Thử nghiệm xác thực việc liên kết tài khoản chứa các thử nghiệm để xác thực mã truy cậpmã làm mới:

Kiểm tra xác thực mã thông báo truy cập

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

Kiểm thử mục Giải thích
Kiểm tra xem mã truy cập có phải là định dạng JWT hay không Bạn không nên dùng mã thông báo truy cập định dạng JWT khi liên kết với Tài khoản Google. Nếu hệ thống tìm thấy định dạng JWT, bạn sẽ thấy cảnh báo sau: 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ã thông báo truy cập sắp hết 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 này 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 phương thức kiểm tra xác thực mã thông báo

Thử nghiệm làm mới mã thông báo để đảm bảo điểm cuối trao đổi mã thông báo của bạn sẽ trao đổi chúng đúng cách để lấy mã truy cập mới.

Kiểm thử mục 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 HTTP 400 Yêu cầu không hợp lệ với {"error": "invalid_grant"} đối với 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ã 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 nội dung trao đổi mã làm mới cho mã truy cập để biết thêm thông tin.
Kiểm tra xem mã 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 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ử này sẽ không thành công.
Kiểm tra xem mã thông báo 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ã truy cập sẽ xuất hiện.
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 có 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 đã dùng mã làm mới mới để ngăn các tình huống tương tranh có thể làm hỏng việc liên kết tài khoản của người dùng. Thử nghiệm này sẽ không thành công nếu bạn vô hiệu hoá mã thông báo 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 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 API đã bị vô hiệu hoá Đảm bảo rằng bạn đã bật HomeGraph API.
Không tìm thấy đối tượng đượ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 dịch vụ.

Hãy đả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.

Lỗi khi lấy dữ liệu mô-đun: lỗi getModuleData: Phản hồi lỗi https cho https://hometest SuiteProxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. Làm theo hướng dẫn trong 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 cho dự án.
  2. Hãy truy cập 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
      1. Xem địa chỉ email Tài khoản Google chính của bạn
      2. Xem thông tin cá nhân của bạn, bao gồm mọi thông tin cá nhân mà bạn đã đăng công khai
    • Quyền truy cập bổ sung
      1. Sử dụng Assistant: quyền truy cập rộng rãi vào Tài khoản Google của bạn
      2. Kiểm tra và điều khiển các thiết bị nhà thông minh trong Biểu đồ nhà của bạn
    Nếu bạn gặp lỗi về quyền, trước tiên, hãy xoá quyền truy cập và cấp tất cả các quyền trong màn hình xin phép khi bạn đăng nhập lại.

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

Kết quả Test Suite của bạn phải vượt qua 100% thử nghiệm trước khi gửi biểu mẫu 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 tra 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:

  1. Sau khi nhận được kết quả kiểm tra và sẵn sàng nhận giấy chứng nhận về Hành động dành cho nhà thông minh, hãy nhấp vào Gửi trong công cụ Test Suite.
  2. Nhấp vào nút TẢI XUỐNG KẾT QUẢ THỬ NGHIỆM để truy xuất kết quả kiểm tra của bạn.
  3. Nhấp vào BẠN ĐI ĐẾN MẪU GỬI để gửi kết quả thử nghiệm cho Google.
  4. Điền vào tất cả các trường bắt buộc, sau đó nhấp vào Gửi.