API Quản lý thiết bị thông minh sử dụng các mã lỗi gRPC tiêu chuẩn. Để biết thêm thông tin về các mã đó, hãy xem phần xử lý lỗi.
Phản hồi lỗi trong API sẽ xuất hiện theo định dạng sau:
{
"error": {
"code": 404,
"message": "Device enterprises/project-id/devices/device-id not found.",
"status": "NOT_FOUND"
}
}
Sử dụng hộp tìm kiếm trong bảng Mã lỗi để tìm lỗi API, cùng với các mẹo khắc phục sự cố, các đặc điểm và hướng dẫn liên quan. Bạn có thể tìm kiếm nội dung trong bất kỳ trường nào trong bảng.
| Thông báo Lỗi | HTTP | RPC | Khắc phục sự cố |
|---|---|---|---|
| Bạn không thể tải hình ảnh chụp bằng máy ảnh xuống nữa. | 504 | DEADLINE_EXCEEDED |
Hình ảnh sự kiện sẽ hết hạn 30 giây sau khi sự kiện được xuất bản. Hãy nhớ tải hình ảnh xuống trước khi hết hạn. Xem thêm: Tác vụ Tải hình ảnh từ máy ảnh xuống Thiết bị Hiển thị Thiết bị Chuông cửa Hướng dẫn về Sự kiện Lệnh Tạo hình ảnh CameraMotion trường hợp CameraPerson trường hợp CameraSound trường hợp DoorbellChime trường hợp |
| Lệnh không được hỗ trợ cho chuông cửa. | 400 | FAILED_PRECONDITION |
Không thể kéo dài luồng WebRTC trên chuông cửa chạy bằng pin. Nếu cần xem luồng trên chuông cửa sau thời lượng phiên ban đầu, hãy dừng luồng hiện tại và tạo luồng mới. Xem thêm: Tăng thời lượng phát trực tiếp Lệnh ExtendWebRtcStream |
| Không được phép thực hiện lệnh trong chế độ máy điều nhiệt hiện tại. | 400 | FAILED_PRECONDITION |
Một số mẫu máy điều nhiệt không hỗ trợ thay đổi chế độ Tiết kiệm năng lượng khi chế độ máy điều nhiệt đang ở trạng thái TẮT, theo đặc điểm ThermostatMode . Bạn phải thay đổi chế độ máy điều nhiệt thành HEAT (Sưởi ấm), COOL (Làm mát) hoặc HEATCOOL (Sưởi ấm và làm mát) trước khi thay đổi chế độ Tiết kiệm năng lượng. Xem thêm: Thay đổi chế độ tác vụ Lệnh SetMode ThermostatMode trường hợp ThermostatTemperatureSetpoint trường hợp |
| Không được phép thực hiện lệnh khi máy điều nhiệt ở chế độ MANUAL_ECO. | 400 | FAILED_PRECONDITION |
Không thể đặt điểm đặt nhiệt độ khi máy điều nhiệt ở chế độ Tiết kiệm năng lượng thủ công. Xem thêm: Thay đổi điểm đặt nhiệt độ ThermostatEco trait ThermostattemperatureSetpoint trait |
| Không cung cấp lệnh. | 404 | NOT_FOUND |
Một lệnh được thực thi mà không có tên lệnh hợp lệ trong phần nội dung yêu cầu. Nhập một lệnh hợp lệ. |
| Lệnh không được hỗ trợ. | 400 | INVALID_ARGUMENT |
Sử dụng lệnh phát trực tiếp RTSP cho máy ảnh hỗ trợ WebRTC hoặc sử dụng lệnh phát trực tiếp WebRTC cho máy ảnh hỗ trợ RTSP. Xem thêm: Tác vụ Tải hình ảnh máy ảnh xuống |
| Chứa giá trị không hợp lệ. | 400 | INVALID_ARGUMENT |
Một lệnh đã được gửi với giá trị không hợp lệ trong các đối số. Hãy nhớ gửi một giá trị hợp lệ. |
| Giá trị mát phải lớn hơn giá trị nóng. | 400 | INVALID_ARGUMENT |
Đảm bảo rằng trường heatCelsius nhỏ hơn trường coolCelsius trong lệnh của bạn.Xem thêm: Thay đổi điểm đặt nhiệt độ ThermostatTemperatureSetpoint trường |
| Không tìm thấy thiết bị. | 404 | NOT_FOUND |
Bạn đã chỉ định tên thiết bị không hợp lệ hoặc bị thiếu. Chỉ định một thiết bị hợp lệ. Xem thêm: Khả năng kết nối tính năng |
| Không tìm thấy Enterprise. | 404 | NOT_FOUND |
Bạn đã chỉ định một mã Project không hợp lệ hoặc bị thiếu. Hãy chỉ định mã nhận dạng Project hợp lệ. |
| Mã sự kiện không thuộc về máy ảnh. | 400 | FAILED_PRECONDITION |
Sử dụng eventID chính xác do sự kiện máy ảnh trả về.Xem thêm: Tác vụ xử lý sự kiện máy ảnh Thiết bị hiển thị Tác vụ xử lý sự kiện chuông cửa và máy ảnh Hướng dẫn về Sự kiện CameraEventImage trait CameraMotion trait CameraPerson trait CameraSound trait DoorbellChime trait |
| Không truy xuất được SDP câu trả lời do hết thời gian chờ. | 504 | DEADLINE_EXCEEDED |
Hãy thử tạo lại sự kiện phát trực tiếp WebRTC. Xem thêm: |
| Trường không xuất hiện trong đặc điểm. | 400 | INVALID_ARGUMENT |
Đã gửi một lệnh không được hỗ trợ cho một đặc điểm. |
| SDP của ưu đãi không hợp lệ bị thiếu CRLF. | 400 | INVALID_ARGUMENT |
Thiếu ký tự dòng mới ở cuối chuỗi offerSdp khi cố gắng tạo luồng WebRTC. Đảm bảo chuỗi offerSdp kết thúc bằng \r\n hoặc \n và thử tạo lại luồng.Xem thêm: |
| Đường liên kết trực tiếp đến SDP cho ưu đãi không hợp lệ. | 400 | INVALID_ARGUMENT |
SDP của mặt hàng phải chứa cả ba m-line âm thanh, video và ứng dụng theo thứ tự đó. Xem thêm: |
| SDP của ưu đãi không hợp lệ. | 400 | INVALID_ARGUMENT |
Bạn phải đặt âm thanh SDP của ưu đãi thành a=recvonly (chỉ nhận).Xem thêm: |
| Không được cấp quyền. | 403 | PERMISSION_DENIED |
user đã không cấp cho developercác quyền thích hợp ở cấp thiết bị trong Trình quản lý kết nối đối tác (PCM) cần thiết để thực thi lệnh. Khi tạo luồng trực tiếp WebRTC, lỗi này cũng có thể có nghĩa là chế độ cài đặt âm thanh trong offerSdp không chính xác.Xem thêm: tác vụ Liên kết tài khoản của bạn lệnh GenerateWebRtcStream |
| Giới hạn tốc độ. | 429 | RESOURCE_EXHAUSTED |
Mỗi nhà phát triển có một hạn mức giới hạn số lệnh gọi mà họ có thể thực hiện. Nếu thực hiện nhiều cuộc gọi hơn hạn mức, bạn sẽ nhận được thông báo Bị giới hạn tốc độ. Để khắc phục vấn đề này, hãy gửi lại cuộc gọi sau khi hạn mức hết hạn. Xem thêm: Khái niệm về Giới hạn số lượng hộp cát |
| Không tìm thấy phòng. | 404 | NOT_FOUND |
Phòng không tồn tại trong cấu trúc. Gọi danh sách đến tài nguyên của phòng để xác minh mã phòng. |
| Không tìm thấy cấu trúc. | 404 | NOT_FOUND |
Cấu trúc này không tồn tại trong Project. Thực hiện lệnh gọi danh sách đến tài nguyên cấu trúc để xác minh mã nhận dạng cấu trúc. |
| Không thể truyền trực tuyến bằng máy ảnh. | 400 | FAILED_PRECONDITION |
Camera không có kết nối mạng hoặc không phát trực tuyến được do sự cố kỹ thuật. Xem thêm: Thiết bị Camera Thiết bị Camera (pin) Thiết bị Camera (có dây) Thiết bị Chime (pin) Thiết bị Chime (có dây) Lệnh GenerateWebRtcStream |
| Quạt máy điều nhiệt không hoạt động. | 400 | FAILED_PRECONDITION |
Máy điều nhiệt không có chức năng quạt. Không sử dụng được các lệnh và đặc điểm liên quan đến quạt trên thiết bị này. Xem thêm: Bật hoặc tắt quạt nhiệm vụ Quạt tính năng |