Bạn nên tạo ứng dụng thực hiện đơn hàng cục bộ theo các bước được mô tả trước đó, sau đó thử nghiệm việc 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ách làm theo 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 cục bộ. Đoạn mã sau đây cho thấy ví dụ về một tệp HTML tĩnh chạy ứng dụng thực hiện cục bộ của bạn.
<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 từ Chrome. Dùng đ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, 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à thử nghiệm này, bạn có thể thấy các thay đổi của mình hoạt động như thế nào phát hiện và gỡ lỗi các sự cố liên quan đến mã của bạn một cách nhanh chóng và dễ dàng hơn.
Kiểm soát thiết bị thử nghiệm
Trong Bảng điều khiển hành động, bạn cần chỉ định URL của ứng dụng web. phân phối 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ử chế độ đ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 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ộ trên trang chủ (không bắt buộc) > Nhập URL thử nghiệm cho Chrome, chỉ định máy chủ phát triển URL 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 áp dụng 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. Ví dụ: nếu thiết bị của bạn triển khai tính năng OnOff, bạn có thể nói "Ok Google, bật đèn".
Node.js
- Mở dự án Nhà thông minh 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ộ trên trang chủ (không bắt buộc) > Nhập URL thử nghiệm cho Nút, chỉ định máy chủ phát triển URL phân phát JavaScript giúp 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 áp dụng 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. Ví dụ: nếu thiết bị của bạn triển khai tính năng OnOff, 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 Được hỗ trợ thiết bị.
Gỡ lỗi từ Chrome
Bạn có thể gỡ lỗi ứng dụng thực hiện cục bộ bằng Chrome Công cụ cho nhà phát triển. Trước khi bạn có thể gỡ lỗi, hãy đảm bảo rằng môi trường của bạn được thiết lập đúng cách:
- Bạn đã đặt URL phát triển trong bảng điều khiển thành URL có thể truy cập 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 gói dữ liệu giữa các thiết bị.
- Bạn đã đă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 trên đám mây
thực hiện đơn hàng.
Hàm này phải trả về ít nhất một giá trị hợp lệ trong trường
otherDeviceIds
. - Bạn đã nhập cấu hình quét chính xác của bạn trong bảng điều khiển Actions.
Cách kết nối ứng dụng thực hiện cục bộ với trình gỡ lỗi Công cụ của Chrome cho nhà phát triển: hãy làm theo các bước sau:
Chrome
- Trong máy phát triển cục bộ của bạn, 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 khởi chạy trình kiểm tra Chrome
bằng cách nhập:
chrome://inspect#devices
. Bạn sẽ thấy danh sách thiết bị trên trang và tệp HTML sẽ được liệt kê dưới tên thử nghiệm của bạn Thiết bị Google Home hoặc Google Nest. - Nhấp vào đường liên kết kiểm tra màu xanh dương bên dưới HTML của bạn để chạy Công cụ của Chrome cho nhà phát triển. Chuyển sang thẻ Bảng điều khiển. Nền tảng Local Home xuất ra phiên bản ứng dụng của bạn và SDK Home cục bộ phiên bản trong nhật ký bảng điều khiển. Nếu bạn thấy nhật ký này, điều đó có nghĩa là Google đã đã tải thành công ứng dụng của bạn 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ộ của bạn, 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ị kiểm thử.
- Trong trường địa chỉ của trình duyệt Chrome, hãy khởi chạy trình 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 tính năng Khám phá mục tiêu.
- Nhập
DEVICE_IP_ADDRESS:9222
vào danh sách và hãy 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ụ của Chrome cho nhà phát triển. Chuyển sang thẻ Bảng điều khiển. Nền tảng Local Home xuất ra phiên bản ứng dụng của bạn và SDK Home cục bộ phiên bản trong nhật ký bảng điều khiển. Nếu bạn thấy nhật ký này, điều đó có nghĩa là Google đã đã tải thành công ứng dụng của bạn 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 Được hỗ trợ Thiết bị.
Mẹo gỡ lỗi
Sau đây là một số điều khác cần lưu ý trong quá trình gỡ lỗi:
- Đừng liên kết nhiều thiết bị Google Home hoặc Google Nest với cùng một tài khoản thử nghiệm của bạn 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ụ của Chrome cho nhà phát triển để 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. Việc này không đặt lại
Nền tảng Local Home (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 đơn hàng cục bộ. Cách đặt lại nền tảng Local Home: 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 tải mà không gặp lỗi. Để thực hiện việc này, hãy chọn
phần bảng điều khiển của trang Công cụ cho nhà phát triển. Nếu có sự cố, bạn sẽ thấy
một tin nhắn như thế này:
Uncaught TypeError: Cannot read property ‘open’ of null.
verificationId
trong phản hồiIDENTIFY
phải khớp với một trongotherDeviceIds
trong phản hồiSYNC
.- Đối với trình xử lý
EXECUTE
, hãy đảm bảo các lệnh HTTP, TCP hoặc UDP của bạn có thể được mà thiết bị của bạn nhận được và hoạt động như mong đợi. - Hãy nhớ trả về
Promise
từ các trình xử lý. - Tránh duy trì trạng thái chung trong bộ nhớ. Xem phần Vòng đời của ứng dụng.
- Các lỗi do ứng dụng thực hiện cục bộ gửi sẽ xuất hiện trong dự án của bạn nhật ký lỗi.
Chuẩn bị và phát hành công khai
Khi bạn đã sẵn sàng triển khai Hành động nhà thông minh, hãy làm theo các bước sau:
- Mở 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 gói JavaScript sau đây 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 > Thao tác. Trong phần Định cấu hình SDK cho Home cục bộ, hãy nhấp vào Tải lên JavaScript.
- Trong hộp thoại Upload files (Tải tệp lên), hãy tải các tệp gói mà bạn lên trước đây
tạo. Hãy nhớ tải cả hai phiên bản của tệp gói lên (Nút, Web)
để Hành động của bạn được định cấu hình hoạt động chính xác trong toàn bộ thời gian chạy
môi trường mà phương thức thực hiện cục bộ hỗ trợ.
- Tải Node.js nhắm mục tiêu JavaScript lên: Tải
bundle.js
lên từ thư mụcdist/node
. - Tải lên Chrome nhắm mục tiêu JavaScript (trình duyệt): Tải lên
bundle.js
trong thư mụcdist/web
.
- Tải Node.js nhắm mục tiêu JavaScript lên: Tải
- Kiểm thử Hành động của bạn trên một 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 Thử nghiệm và chia sẻ Hành động trong 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 để bằng cách làm theo hướng dẫn trong Khởi chạy Hành động trong nhà thông minh. Chiến dịch này bao gồm việc hoàn thành các bước yêu cầu tự kiểm tra và chứng nhận.