Akıllı Ev Kapı Zili Kılavuzu
action.devices.types.DOORBELL - Kapı zilleri, kullanıcılara kapıda olduğunu bildirebilir.
Bu cihaz, ilgili özelliklere sahipse bildirim gönderebilir ve video akışı sağlayabilir.
Bu tür, cihazın Kapı zili simgesini ve ilgili bazı eş anlamlıları ve takma adları aldığını gösterir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar, ayrıca EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik dokümanlarına bakın.
Önerilen özellikler
Cihazınız için geçerliyse bu özellikler önerilir. Ancak mevcut ürün işlevlerinizle en iyi eşleşmeyi sağlamak için mevcut tüm özelliklerle karıştırabilir ve eşleştirebilirsiniz.
Kalite gereksinimleri
- Gecikme: 2.000 ms'den küçük veya buna eşit olmalıdır.
- Güvenilirlik: %97'den fazla veya bu değere eşit olmalıdır.
Örnek cihaz: Basit kapı zili
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere dayalı olarak ortak bir "Kapı zilini" temsil eden amaç yükü örnekleri yer alır. Uygulamanıza özellikler ekler veya mevcut özellikleri kaldırırsanız yanıtlarınızı bu değişiklikleri yansıtacak şekilde değiştirin.
Örnek SYNC yanıtı
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.DOORBELL",
"traits": [
"action.devices.traits.CameraStream",
"action.devices.traits.ObjectDetection"
],
"name": {
"name": "Simple doorbell"
},
"willReportState": true,
"notificationSupportedByAgent": true,
"attributes": {
"cameraStreamSupportedProtocols": [
"hls"
],
"cameraStreamNeedAuthToken": true
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Örnek QUERY yanıtı
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true
}
}
}
}
Örnek EXECUTE komutları
CameraStream alma
Komut parametreleri hakkında daha fazla bilgi için action.devices.traits.CameraStream referansına bakın.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.GetCameraStream",
"params": {
"StreamToChromecast": true,
"SupportedStreamProtocols": [
"hls"
]
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"cameraStreamAccessUrl": "https://example.com/stream.mp4",
"cameraStreamProtocol": "hls"
}
}
]
}
}
Örnek NOTIFICATIONS raporu
Nesne Algılama
Bildirim özellikleri hakkında ek ayrıntılar için action.devices.traits.ObjectDetection referansına bakın.
{
"requestId": "6894439706274654518",
"payload": {
"devices": {
"notifications": {
"123": {
"ObjectDetection": {
"objects": {
"named": [
"Alice"
]
},
"priority": 0,
"detectionTimestamp": 946684800000
}
}
}
}
}
}
{
"requestId": "6894439706274654518"
}