Bạn nên xây dựng ứng dụng thực hiện đơn hàng tại địa phương bằng cách làm theo các bước như mô tả trước đó, sau đó kiểm thử quá trình tích hợp nhà thông minh trên môi trường lưu trữ của riêng bạn bằng các bước sau:
Trong môi trường lưu trữ của riêng bạn, hãy phân phát trang HTML chạy ứng dụng thực hiện đơn hàng tại địa phương. Đoạn mã sau đây cho thấy một ví dụ về tệp HTML tĩnh chạy ứng dụng thực hiện cục bộ.
<html> <head> <!-- Local Home SDK --> <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script> <!-- Local app under development --> <script src="local_execution.js"></script> </head> </html>
Gỡ lỗi trên Chrome. Sử dụng các điểm ngắt và nhật ký để khắc phục sự cố tích hợp.
Sửa đổi và biên dịch mã TypeScript của bạn, sau đó lặp lại các bước này.
Bằng cách lặp lại quy trình tạo và kiểm thử này, bạn có thể xem các thay đổi trong thực tế một cách nhanh chóng và dễ dàng hơn trong việc phát hiện và gỡ lỗi các vấn đề với mã của mình.
Kiểm thử điều khiển thiết bị
Trong Bảng điều khiển hành động, bạn cần chỉ định URL của ứng dụng web. URL này phân phát HTML được tải trên thiết bị Google Home hoặc Google Nest trong quá trình thực hiện cục bộ.
Để kiểm thử điều khiển thiết bị bằng phương thức thực hiện cục bộ, hãy làm theo các bước sau:
Chrome
- Mở dự án Nhà thông minh của bạn trong bảng điều khiển Actions.
- Trong bảng điều hướng bên trái, hãy nhấp vào Hành động.
- Trong phần Định cấu hình SDK cục bộ cho nhà riêng (không bắt buộc) > Nhập URL thử nghiệm của bạn cho Chrome, chỉ định URL máy chủ phát triển phân phát HTML chạy ứng dụng thực hiện cục bộ của bạn.
- Nhấp vào Lưu. Có thể mất đến 30 phút để Google phổ biến các thay đổi trên bảng điều khiển của bạn.
- Khởi động lại thiết bị Google Home hoặc Google Nest thử nghiệm.
- Ra lệnh cho thiết bị thông minh của bạn. Ví dụ: nếu thiết bị của bạn triển khai đặc điểm OnOff, thì bạn có thể nói "Ok Google, bật đèn".
Node.js
- Mở dự án Nhà thông minh của bạn trong bảng điều khiển Actions.
- Trong bảng điều hướng bên trái, hãy nhấp vào Hành động.
- Trong phần Định cấu hình SDK cục bộ cho nhà riêng (không bắt buộc) > Nhập URL thử nghiệm cho Nút, chỉ định URL máy chủ phát triển phân phát JavaScript chạy ứng dụng thực hiện cục bộ.
- Nhấp vào Lưu. Có thể mất đến 30 phút để Google phổ biến các thay đổi trên bảng điều khiển của bạn.
- Khởi động lại thiết bị Google Home hoặc Google Nest thử nghiệm.
- Ra lệnh cho thiết bị thông minh của bạn. Ví dụ: nếu thiết bị của bạn triển khai đặc điểm OnOff, thì bạn có thể nói "Ok Google, bật đèn".
Để biết thêm thông tin chi tiết về thời gian chạy mà thiết bị của bạn sử dụng, hãy xem phần Thiết bị được hỗ trợ.
Gỡ lỗi từ Chrome
Bạn có thể gỡ lỗi ứng dụng thực hiện đơn hàng tại địa phương bằng Công cụ cho nhà phát triển Chrome. Trước khi gỡ lỗi, hãy đảm bảo bạn đã thiết lập môi trường đúng cách:
- Bạn đã đặt URL phát triển trong bảng điều khiển thành một URL có thể truy cập được bằng thiết bị Google Home hoặc Google Nest (trên mạng cục bộ hoặc qua Internet),
- Máy của bạn được kết nối với cùng một mạng cục bộ như thiết bị Google Home hoặc Google Nest mà bạn đang thử nghiệm.
- Mạng của bạn không chặn các gói giữa các thiết bị.
- Bạn đang đăng nhập bằng cùng một Tài khoản Google trên bảng điều khiển Actions và trên thiết bị Google Home hoặc Google Nest.
- Bạn đã cập nhật phản hồi SYNC trong quá trình thực hiện đám mây.
Giá trị trả về phải có ít nhất một giá trị hợp lệ trong trường
otherDeviceIds
. - Bạn đã nhập thông tin cấu hình quét chính xác trong bảng điều khiển Actions.
Để kết nối ứng dụng thực hiện đơn hàng tại địa phương với trình gỡ lỗi Chrome DevTools, hãy làm theo các bước sau:
Chrome
- Trong máy phát triển cục bộ, hãy cài đặt và khởi chạy trình duyệt Google Chrome.
- Trong trường địa chỉ của trình duyệt Chrome, hãy chạy công cụ kiểm tra Chrome
bằng cách nhập:
chrome://inspect#devices
. Bạn sẽ thấy danh sách các thiết bị trên trang và tệp HTML của bạn phải được liệt kê dưới tên của thiết bị Google Home hoặc Google Nest thử nghiệm. - Nhấp vào đường liên kết kiểm tra màu xanh dương bên dưới HTML để chạy Công cụ dành cho nhà phát triển của Chrome. Chuyển sang thẻ Bảng điều khiển. Nền tảng Home Home sẽ xuất phiên bản ứng dụng của bạn và phiên bản SDK Home cục bộ trong nhật ký bảng điều khiển. Nếu bạn thấy nhật ký này tức là Google đã tải ứng dụng của bạn thành công và có thể kết nối với ứng dụng đó. Nếu không, hãy khởi động lại thiết bị Google Home hoặc Google Nest.

Node.js
- Trong máy phát triển cục bộ, hãy cài đặt và khởi chạy trình duyệt Google Chrome.
- Xác định địa chỉ IP cục bộ của thiết bị thử nghiệm.
- Trong trường địa chỉ của trình duyệt Chrome, hãy chạy công cụ kiểm tra Chrome
bằng cách nhập:
chrome://inspect#devices
. - Chọn Định cấu hình... để mở phần Cài đặt phát hiện mục tiêu.
- Nhập
DEVICE_IP_ADDRESS:9222
trong danh sách và nhấp vào Xong. - Nhấp vào đường liên kết kiểm tra màu xanh dương bên dưới tập lệnh của bạn để chạy Công cụ dành cho nhà phát triển của Chrome. Chuyển sang thẻ Bảng điều khiển. Nền tảng Home Home sẽ xuất phiên bản ứng dụng của bạn và phiên bản SDK Home cục bộ trong nhật ký bảng điều khiển. Nếu bạn thấy nhật ký này tức là Google đã tải ứng dụng của bạn thành công và có thể kết nối với ứng dụng đó. Nếu không, hãy khởi động lại thiết bị Google Home hoặc Google Nest.

Để biết thêm thông tin chi tiết về thời gian chạy mà thiết bị của bạn sử dụng, hãy xem phần Thiết bị được hỗ trợ.
Mẹo gỡ lỗi
Sau đây là một số điểm khác cần lưu ý trong quá trình gỡ lỗi:
- Không liên kết nhiều thiết bị Google Home hoặc Google Nest với tài khoản thử nghiệm trên cùng một mạng cục bộ. Bạn sẽ không thể kiểm soát thiết bị Google Home hoặc Google Nest nào được nhắm đến bằng các lệnh thực hiện cục bộ.
- Làm mới trang trong Công cụ dành cho nhà phát triển của Chrome để tải lại vùng chứa ứng dụng thực hiện cục bộ bằng mã mới nhất từ URL phát triển của bạn. Thao tác này sẽ không đặt lại nền tảng
Home Home, việc này có thể cần thiết để kích hoạt lại ý định của nền tảng
(chẳng hạn như
IDENTIFY
) trong ứng dụng thực hiện cục bộ. Để đặt lại nền tảng Home, hãy khởi động lại thiết bị Google Home hoặc Google Nest. - Kiểm tra để đảm bảo rằng ứng dụng JavaScript của bạn tải được mà không gặp lỗi. Để làm điều này, hãy kiểm tra
bảng điều khiển của trang Công cụ cho nhà phát triển. Nếu xảy ra sự cố, bạn sẽ thấy
thông báo như sau:
Uncaught TypeError: Cannot read property ‘open’ of null.
verificationId
từ phản hồiIDENTIFY
phải khớp với một trong cácotherDeviceIds
từ phản hồiSYNC
.- Đối với trình xử lý
EXECUTE
, hãy đảm bảo thiết bị của bạn có thể nhận được các lệnh HTTP, TCP hoặc UDP và hoạt động như mong đợi. - Hãy nhớ trả về một
Promise
từ trình xử lý. - Tránh duy trì trạng thái toàn cục trong bộ nhớ. Xem Vòng đời của ứng dụng.
- Các lỗi do ứng dụng thực hiện đơn hàng địa phương gửi sẽ xuất hiện trong nhật ký lỗi của dự án.
Chuẩn bị và ra mắt phiên bản chính thức
Khi bạn đã sẵn sàng ra mắt Hành động dành cho nhà thông minh, hãy làm theo các bước sau:
- Mở một cửa sổ dòng lệnh. Trong thư mục dự án, hãy chạy lệnh
npm run build
. Lệnh này tạo ra các gói JavaScript sau cho ứng dụng của bạn trong thư mụcdist
:project-directory/ └── dist ├── web │ └── bundle.js └── node └── bundle.js
- Trong bảng điều khiển, hãy tải ứng dụng JavaScript của bạn lên bằng cách nhấp vào Phát triển > Hành động. Trong phần Định cấu hình SDK cục bộ cho nhà riêng, hãy nhấp vào Tải tệp JavaScript lên.
Hình 3: Tải ứng dụng JavaScript lên. - Trong hộp thoại Tải tệp lên, hãy tải các tệp gói mà bạn đã tạo trước đó lên. Hãy nhớ tải cả hai phiên bản của tệp gói (Nút, Web) lên để Hành động được định cấu hình để hoạt động chính xác trên tất cả môi trường thời gian chạy mà phương thức thực hiện cục bộ hỗ trợ.
- Tải tệp Node.js lên để nhắm mục tiêu JavaScript: Tải tệp
bundle.js
lên từ thư mụcdist/node
. - Tải tệp JavaScript nhắm mục tiêu Chrome (trình duyệt) lên: Tải tệp
bundle.js
lên từ thư mụcdist/web
.
- Tải tệp Node.js lên để nhắm mục tiêu JavaScript: Tải tệp
- Kiểm thử Hành động của bạn trên thiết bị có Trợ lý để xác minh rằng hành động đó hoạt động như mong đợi trong môi trường sản xuất. Để tìm hiểu thêm, hãy xem bài viết Kiểm tra và chia sẻ Hành động dành cho nhà thông minh của bạn.
- Khi bạn đã hài lòng với cách thức hoạt động của Hành động, hãy gửi hành động đó cho Google để triển khai thực tế bằng cách làm theo hướng dẫn trong bài viết Chạy Hành động dành cho nhà thông minh của bạn. Điều này bao gồm hoàn thành các bước yêu cầu tự kiểm tra và chứng nhận.