Khắc phục sự cố

Ứng dụng mẫu

Nếu gặp vấn đề khi sử dụng Home API, bạn có thể thu thập nhật ký để gỡ lỗi thêm. Bạn cần có Xcode để thu thập nhật ký từ thiết bị di động. Nếu bạn cần được Google hỗ trợ, hãy thu thập nhật ký từ cả thiết bị iOS và trung tâm, rồi mở một phiếu yêu cầu hỗ trợ trong trình theo dõi vấn đề kèm theo thông tin và nhật ký liên quan.

Thu thập nhật ký iOS

Thiết bị di động của bạn phải được kết nối với máy cục bộ cho tất cả các bước liên quan đến Xcode.

Nhật ký ứng dụng và nhật ký SDK được hiển thị và có thể thu thập trực tiếp trong bảng điều khiển Xcode. Khi thiết bị di động của bạn được kết nối với máy cục bộ và bạn chạy ứng dụng thông qua Xcode, bảng điều khiển sẽ tự động ghi lại và truyền trực tuyến nhật ký đầu ra chuẩn (stdout) và lỗi chuẩn (stderr) từ cả lớp ứng dụng và Home SDK tích hợp. Điều này giúp bạn dễ dàng theo dõi các quy trình khởi tạo theo thời gian thực, hoạt động tương tác API và sự kiện SDK trong quá trình phát triển và gỡ lỗi.

Thu thập nhật ký tiện ích từ Xcode

Nếu gặp vấn đề khi sử dụng Home API, bạn có thể thu thập nhật ký để gỡ lỗi thêm.

1. Trong Xcode, hãy chuyển đến Debug (Gỡ lỗi) trên thanh trình đơn trên cùng rồi nhấp vào Attach to Process by PID or Name (Gắn vào quy trình theo PID hoặc tên).

   

2. Trong mục PID hoặc Tên quy trình, hãy chọn MatterExtension rồi nhấp vào Đính kèm.

   

3. Bạn sẽ thấy thông báo Waiting to attach to MatterAddDeviceExtension on iPhone (Đang chờ kết nối với MatterAddDeviceExtension trên iPhone) nếu nhấp vào góc trên cùng bên phải.

   

4. Nhấp vào thẻ này rồi chọn MatterAddExtension.

   

5. Bảng điều khiển sẽ ghi nhật ký Tiện ích.

Sherlog: Theo dõi sự kiện trên nhiều ngăn xếp

Sherlog là một dịch vụ theo dõi theo thời gian thực, cung cấp thông tin tổng quan toàn diện về các hoạt động tương tác giữa cơ sở hạ tầng của Google và các dịch vụ đám mây của đối tác.

Điều kiện tiên quyết: Để theo dõi, bạn cần sử dụng một tài khoản dùng chung do Google điều phối (ví dụ: tài khoản đã đăng ký GReg hoặc tài khoản dùng thử).

Mục đích cốt lõi: Gỡ lỗi các lỗi chức năng và vấn đề tích hợp từ đám mây đến đám mây (C2C) (ví dụ: lỗi liên kết tài khoản hoặc trạng thái thiết bị không chính xác) mà không cần thay đổi mã sản xuất.

Các chức năng: Cung cấp biểu đồ lệnh gọi RPC hoàn chỉnh, tải trọng yêu cầu/phản hồi và siêu dữ liệu cho các ý định SYNC, EXECUTE, QUERY và Account Linking.

Nhật ký thiết bị trung tâm Fuchsia

Bạn có thể thu thập nhật ký từ các trung tâm Fuchsia sau đây bằng phương pháp này: * Google Nest Hub (thế hệ thứ 2) * Google Nest Hub Max

Cách bật một trung tâm để truy xuất nhật ký cục bộ:

1. Gửi email có Số sê-ri và Mô hình của thiết bị cho Nhà quản lý tài khoản hỗ trợ kỹ thuật (TAM) của Google. Bạn có thể tìm thấy các thông tin này bằng chữ nhỏ bên dưới thiết bị.
2. Sau khi được đưa vào danh sách cho phép, bạn phải bật tính năng này bằng cách làm theo các bước sau:
   • Trên trung tâm:
     1. Vuốt xuống từ đầu màn hình
     2. Nhấn vào biểu tượng Cài đặt settings
     3. Tìm Phiên bản Fuchsia: Trên Nest Hub (thế hệ thứ 2), hãy chuyển đến phần Thông tin thiết bị > Thông tin kỹ thuật > Phiên bản Fuchsia
     4. Nhấn 7 lần vào "Phiên bản Fuchsia". Thao tác này sẽ bật các tuỳ chọn cho nhà phát triển
     5. Quay lại trình đơn cấp cao nhất
     6. Nhấn vào "Tuỳ chọn cho nhà phát triển"
     7. Nhấn vào "Nhật ký hoạt động của đối tác"
   • Tính năng này sẽ được bật trong 24 giờ. Sau đó, hãy bật lại tính năng ghi nhật ký từ bước 5 trở đi.
3. Lấy địa chỉ IP của trung tâm:
   • Trên trung tâm (nếu trung tâm có màn hình):
     1. Vuốt xuống từ đầu màn hình
     2. Nhấn vào biểu tượng Cài đặt settings
     3. Tìm địa chỉ IP của thiết bị: Trên Nest Hub (thế hệ thứ 2), hãy chuyển đến phần Thông tin thiết bị > Thông tin kỹ thuật > Địa chỉ IP
   • Từ ứng dụng Google Home (GHA) trên điện thoại:
   • Nhấn vào thiết bị để mở trang thông tin chi tiết về thiết bị
   • Nhấn vào biểu tượng Cài đặt settings để mở trang cài đặt
   • Tìm địa chỉ IP của thiết bị: chuyển đến phần Thông tin thiết bị > Thông tin kỹ thuật > Địa chỉ IP
4. Để truy xuất nhật ký từ trung tâm, bạn sẽ thực hiện một yêu cầu GET HTTP đến trung tâm từ máy tính trên cùng một mạng Wi-Fi.
   • Ghi lại cổng và đường dẫn của điểm cuối:

     curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
     

   • Bạn chỉ có thể duy trì kết nối trong một phút, nhưng dữ liệu truy xuất từ vùng đệm thường có các sự kiện trong 20 đến 30 phút trước đó.
     • Tốt nhất là bạn nên trích xuất nhật ký bằng phương thức này ngay sau khi hoàn tất quy trình kiểm thử để đảm bảo vùng đệm chứa nội dung liên quan đến kiểm thử (tương tự như báo cáo lỗi của Android).

Tự động hoá

Phát hiện đường viền

Các quy trình tự động hoá trong hệ sinh thái Google Home có tính năng phát hiện cạnh. Đây là logic xác minh rằng một quy trình tự động hoá chỉ kích hoạt khi có thay đổi trạng thái thực tế, thay vì bản cập nhật trạng thái chỉ lặp lại trạng thái trước đó của thiết bị.

Ví dụ: nếu bật đèn là một điều kiện khởi động, thì tính năng phát hiện cạnh sẽ xác minh rằng điều kiện khởi động chỉ kích hoạt nếu thiết bị đèn đó chuyển từ trạng thái tắt sang bật, thay vì từ trạng thái bật sang bật (không có thay đổi).

Tính năng tự động hoá không hoạt động như mong đợi

Sau khi tính đến việc phát hiện cạnh, nếu một quy trình tự động hoá không hoạt động như mong đợi:

1. Kiểm tra từng thiết bị để đảm bảo rằng thiết bị đang hoạt động đúng cách mà không phụ thuộc vào quy trình tự động hoá của bạn.

2. Xem biểu đồ tự động hoá cho quy trình tự động hoá của bạn, so sánh biểu đồ đó với DSL tự động hoá để phát hiện mọi giả định có thể không chính xác về phía bạn.

3. Theo dõi trạng thái thiết bị trong ứng dụng Google Home trong quá trình thực thi quy trình tự động hoá.

4. Kiểm tra để đảm bảo rằng tất cả các thiết bị mà quy trình tự động hoá tham chiếu đều có trong cấu trúc mà bạn muốn. Việc xoá một thiết bị mà một quy trình tự động hoá phụ thuộc vào có thể gây ra những hậu quả không mong muốn. Xem phần Ảnh hưởng của việc xoá thiết bị đối với các hoạt động tự động hoá.

Quy trình tự động hoá chạy khi không nên

Nếu quy trình tự động hoá chạy khi không nên chạy, hãy xem xét các tiêu chí bắt đầu. Bạn có thể cần thêm logic bổ sung để đảm bảo rằng một thay đổi về trạng thái chỉ được ghi lại một lần và chỉ kích hoạt quy tắc tự động một lần.

Quy trình tự động hoá không biên dịch

Đảm bảo ứng dụng của bạn chứa tất cả các nội dung nhập cần thiết, bao gồm cả từng lớp tương ứng với các loại nút khác nhau cũng như các đặc điểm mà bạn đang tham chiếu.

Quy trình tự động hoá không vượt qua được bước xác thực

Nếu quá trình tạo quy trình tự động hoá không vượt qua quy trình xác thực, thì một thông báo cảnh báo hoặc lỗi sẽ cung cấp thông tin về vấn đề. Để biết thêm thông tin, hãy tham khảo ValidationIssueType.

OAuth

Nếu bạn đã có ứng dụng OAuth

Nếu đã có một ứng dụng OAuth được xác minh cho một ứng dụng đã xuất bản, bạn có thể dùng ứng dụng OAuth hiện có để kiểm thử Home API.

Bạn không cần đăng ký Google Home Developer Console để kiểm thử và sử dụng Home API. Tuy nhiên, bạn vẫn cần đăng ký Developer Console được phê duyệt để xuất bản ứng dụng, ngay cả khi bạn có một ứng dụng OAuth đã xác minh từ một quy trình tích hợp khác.

Bạn cần cân nhắc những điểm sau:

• Có giới hạn 100 người dùng khi sử dụng ứng dụng OAuth hiện có. Để biết thông tin về cách thêm người dùng thử nghiệm, hãy tham khảo phầnTạo mã ứng dụng OAuth. Ngoài quy trình xác minh OAuth, Home API còn áp đặt giới hạn 100 người dùng có thể cấp quyền cho ứng dụng của bạn. Hạn chế này sẽ được gỡ bỏ sau khi bạn hoàn tất quy trình đăng ký Developer Console.

• Developer Consoleđăng ký sẽ được gửi để phê duyệt khi bạn sẵn sàng hạn chế các cấp phép theo loại thiết bị thông qua OAuth để chuẩn bị cập nhật ứng dụng bằng Home API.

Đối với những ứng dụng Google Cloud vẫn đang chờ xác minh OAuth, người dùng không thể hoàn tất quy trình OAuth cho đến khi quy trình xác minh hoàn tất. Nếu bạn tìm cách cấp quyền, thì sẽ gặp lỗi sau:

Access blocked: <Project Name> has not completed the Google verification process.