API Quản lý thiết bị thông minh sử dụng mã lỗi gRPC tiêu chuẩn. Thông tin khác trên 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 ở đị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 các lỗi API, cùng với các mẹo khắc phục sự cố, đặc điểm và hướng dẫn có liên quan. Bạn có thể tìm nội dung vào trường bất kỳ trong bảng.
| Thông báo Lỗi | HTTP | RPC | Khắc phục sự cố |
|---|---|---|---|
| Hình ảnh camera không còn có sẵn để tải xuống. | 504 | DEADLINE_EXCEEDED |
Hình ảnh sự kiện sẽ hết hạn sau 30 giây kể từ khi sự kiện được xuất bản. Đừng quên tải hình ảnh xuống trước khi hết hạn. Xem thêm: Nhiệm vụ Tải hình ảnh camera 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 GenerateImage CameraMotion trait CameraPerson trait CameraSound trait DoorbellChime trait |
| Không hỗ trợ lệnh thoại 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 một luồng phát trên chuông cửa sau thời lượng của phiên ban đầu, hãy dừng luồng hiện có rồi tạo một luồng mới. Xem thêm: Tác vụ Mở rộng sự kiện phát trực tiếp Lệnh ExtendWebRtcStream |
| Không dùng được lệnh ở 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 TẮT, theo tính năng ThermostatMode . Bạn phải chuyển máy điều nhiệt thành SƯỞI ẤM, LÀM MÁT hoặc SƯỞI ẤM trước khi thay đổi chế độ Tiết kiệm năng lượng. Xem thêm: Tác vụ Thay đổi chế độ Lệnh SetMode ThermostatMode trait ThermostatTemperatureSetpoint trait |
| Không được phép dùng 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: Tác vụ Thay đổi điểm đặt nhiệt độ ThermostatEco trait ThermostatTemperatureSetpoint trait |
| Chưa 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ệ. |
| Không hỗ trợ lệnh. | 400 | INVALID_ARGUMENT |
Dùng lệnh phát trực tiếp RTSP cho máy quay có hỗ trợ WebRTC hoặc dùng lệnh phát trực tiếp qua WebRTC cho máy quay có hỗ trợ RTSP. Xem thêm: Nhiệm vụ Tải hình ảnh camera xuống |
| Chứa một giá trị không hợp lệ. | 400 | INVALID_ARGUMENT |
Bạn đã gửi một lệnh có giá trị không hợp lệ trong các đối số. Hãy đảm bảo bạn gửi một giá trị hợp lệ. |
| Giá trị làm mát phải lớn hơn giá trị nhiệt. | 400 | INVALID_ARGUMENT |
Đảm bảo trường heatCelsius nhỏ hơn trường coolCelsius trong lệnh của bạn.Xem thêm: Tác vụ Thay đổi điểm đặt nhiệt độ ThermostatTemperatureSetpoint trait |
| 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. Hãy chỉ định một thiết bị hợp lệ. Xem thêm: Connectivity trait |
| Không tìm thấy Enterprise. | 404 | NOT_FOUND |
Bạn đã chỉ định mã nhận dạng 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ề camera. | 400 | FAILED_PRECONDITION |
Sử dụng đúng eventID do sự kiện máy ảnh trả về.Xem thêm: Xử lý các sự kiện liên quan đến camera Thiết bị hiển thị Xử lý sự kiện liên quan đến chuông cửa và camera 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ợ để tìm một trait. |
| SDP ư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 rồi thử tạo lại sự kiện phát trực tiếp.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 ưu đãi phải chứa cả ba dòng â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 chưa cấp developer
cá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 một
. Khi bạn tạo một sự kiện phát 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: Nhiệm vụ Liên kết tài khoản Lệnh GenerateWebRtcStream |
| Mức giới hạn. | 429 | RESOURCE_EXHAUSTED |
Mỗi nhà phát triển có một hạn mức giới hạn số lượng 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ết hạn mức. Xem thêm: Khái niệm về Giới hạn số lượng của hộp cát |
| Không tìm thấy phòng. | 404 | NOT_FOUND |
Phòng không tồn tại trong nhà. 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. |
| Camera không dùng được để phát trực tuyến. | 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 vấn đề kỹ thuật. Xem thêm: Thiết bị máy ảnh Thiết bị Máy ảnh (pin) Thiết bị Máy ảnh (có dây) Thiết bị chuông cửa (pin) Thiết bị chuông cửa (có dây) Lệnh GenerateWebRtcStream |
| Không dùng được quạt điều nhiệt. | 400 | FAILED_PRECONDITION |
Máy điều nhiệt không có chức năng quạt. Không 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: Việc cần làm là Bật hoặc tắt quạt Fan trait |