Akıllı Ev Ağ Kontrolü Özellik Şeması
action.devices.traits.NetworkControl
: Bu özellik, ağ verilerini raporlamayı ve ağa özel işlemleri gerçekleştirmeyi destekleyen cihazlara aittir.
Cihaz ATTRIBUTES
Bu özelliğe sahip cihazlar, SYNC
işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC
amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
Özellikler | Tür | Açıklama |
---|---|---|
supportsEnablingGuestNetwork |
Boole |
(Varsayılan: Misafir ağı etkinleştirilebiliyorsa true değerine ayarlayın. |
supportsDisablingGuestNetwork |
Boole |
(Varsayılan: Misafir ağı devre dışı bırakılabiliyorsa true olarak ayarlayın. |
supportsGettingGuestNetworkPassword |
Boole |
(Varsayılan: Misafir ağ şifresi |
networkProfiles |
Dizi |
Desteklenen ağ profili adlarını belirtir. |
[item, ...] |
String |
İlgili cihazlardan oluşan bir grubu temsil eden ağ profilinin adı. |
supportsEnablingNetworkProfile |
Boole |
(Varsayılan: Ağ profilleri etkinleştirilebiliyorsa doğru değerine ayarlayın. |
supportsDisablingNetworkProfile |
Boole |
(Varsayılan: Ağ profilleri devre dışı bırakılabiliyorsa true olarak ayarlayın. |
supportsNetworkDownloadSpeedTest |
Boole |
(Varsayılan: İndirme hızı testi çalıştırılabiliyorsa true (doğru) değerine ayarlayın. |
supportsNetworkUploadSpeedTest |
Boole |
(Varsayılan: Yükleme hız testi çalıştırılabiliyorsa true (doğru) değerine ayarlayın. |
Örnekler
Misafir ağını, profilleri ve hız testini destekleyen ağ cihazı
{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true, "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true, "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true, "supportsGettingGuestNetworkPassword": true, "networkProfiles": [ "Kids" ] }
Cihaz STATES
Bu özelliğe sahip varlıklar, QUERY
işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY
amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
Eyaletler | Tür | Açıklama |
---|---|---|
networkEnabled |
Boole |
Ana ağın etkin olup olmadığı. |
networkSettings |
Nesne |
Ana ağın SSID'sini içerir. |
ssid |
String |
Zorunludur. Ağ SSID'si. |
guestNetworkEnabled |
Boole |
Misafir ağının etkin olup olmadığı. |
guestNetworkSettings |
Nesne |
Misafir ağının SSID'sini içerir. |
ssid |
String |
Zorunludur. Ağ SSID'si. |
numConnectedDevices |
Integer |
Ağa bağlı cihazların sayısı. |
networkUsageMB |
Number |
MB (megabayt) cinsinden ağ kullanımı. Ağ kullanımı, geçerli fatura döneminde yer almalıdır. Fatura dönemi ağ kullanım sınırı açısından bu durumun izlenmesi faydalı olabilir. |
networkUsageLimitMB |
Number |
MB (megabayt) cinsinden ağ kullanım sınırı. Ağ kullanım sınırı, geçerli fatura dönemi içindedir. |
networkUsageUnlimited |
Boole |
Ağ kullanımının sınırsız olup olmadığı. Doğru değerine ayarlanırsa cihaz durumu networkUsageLimitMB yok sayılır. |
lastNetworkDownloadSpeedTest |
Nesne |
En son ağ indirme hızı testinin sonuçlarını içerir. |
downloadSpeedMbps |
Number |
Son ağ hız testinin Mb/sn (megabit/saniye) cinsinden indirme hızı. |
unixTimestampSec |
Integer |
Son ağ indirme hızı testinin çalıştırıldığı Unix zaman damgası (Unix Epoch'tan itibaren geçen saniye sayısı). |
status |
String |
Son ağ indirme hızı testinin başarılı veya başarısız olduğunu gösterir. Desteklenen değerler:
|
lastNetworkUploadSpeedTest |
Nesne |
En son ağ yükleme hızı testinin sonuçlarını içerir. |
uploadSpeedMbps |
Number |
Son ağ hız testinin Mb/sn (megabit/saniye) cinsinden yükleme hızı. |
unixTimestampSec |
Integer |
Son ağ yükleme hız testinin çalıştırıldığı zamana ait Unix zaman damgası (Unix Epoch'tan itibaren geçen saniye sayısı). |
status |
String |
Son ağ yükleme hızı testinin başarılı veya başarısız olduğunu belirtir. Desteklenen değerler:
|
networkSpeedTestInProgress |
Boole |
(Varsayılan: Şu anda bir hız testinin yapılıp yapılmadığı. |
networkProfilesState |
Nesne |
Ağ profilleri için durum. Bu üst düzey nesne, anahtarın |
<string> |
Nesne |
Tek bir ağ profilinin durumunu depolayan bir nesne. |
enabled |
Boole |
Ağ profilinin mevcut etkin/devre dışı durumu. |
Örnekler
Etkin bir ağa sahip cihaz.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "guestNetworkSettings": { "ssid": "home-network-123-guest" }, "numConnectedDevices": 4, "networkUsageMB": 100.8 }
Etkin bir ağ ve hız testi sonuçlarına sahip cihaz.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "guestNetworkSettings": { "ssid": "home-network-123-guest" }, "numConnectedDevices": 4, "networkUsageMB": 100.8, "lastNetworkDownloadSpeedTest": { "downloadSpeedMbps": 159.8, "unixTimestampSec": 1563215576, "status": "SUCCESS" }, "lastNetworkUploadSpeedTest": { "uploadSpeedMbps": 64.1, "unixTimestampSec": 1563215576, "status": "SUCCESS" } }
Etkin bir ağ ve hız testi devam eden cihaz.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "guestNetworkSettings": { "ssid": "home-network-123-guest" }, "numConnectedDevices": 4, "networkUsageMB": 100.8, "networkSpeedTestInProgress": true }
"Çocuk" ağ profili devre dışı olan cihaz.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "networkProfilesState": { "parents": { "enabled": true }, "kids": { "enabled": false } } }
Cihaz COMMANDS
Bu özelliğe sahip cihazlar, EXECUTE
işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE
amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
action.devices.commands.EnableDisableGuestNetwork
Misafir ağını etkinleştirin veya devre dışı bırakın. PIN ile ikincil kullanıcı doğrulama kullanılmalıdır. Bu komutlar aracılığıyla diğer güvenlik cihazları devre dışı bırakılırsa kullanıcının ev güvenliği etkilenmiş olarak değerlendirilebilir.
Bu komut için aşağıdaki özellikler gerekir:{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true }
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
enable |
Boole |
Zorunludur. True (doğru) , misafir ağını etkinleştirmek için false (yanlış) misafir ağını devre dışı bırakır. |
Örnekler
Misafir ağını etkinleştirin.
{ "command": "action.devices.commands.EnableDisableGuestNetwork", "params": { "enable": true } }
action.devices.commands.EnableDisableNetworkProfile
Ağ profilini etkinleştirin veya devre dışı bırakın. PIN ile ikincil kullanıcı doğrulama kullanılmalıdır. Bu komutlar aracılığıyla diğer güvenlik cihazları devre dışı bırakılırsa kullanıcının ev güvenliği etkilenmiş olarak değerlendirilebilir.
Bu komut için aşağıdaki özellikler gerekir:{ "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true }
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
profile |
String |
Zorunludur.
|
enable |
Boole |
Zorunludur. True (doğru) profili etkinleştirmek için, false (yanlış) profili devre dışı bırakır. |
Örnekler
Çocuklar için interneti kapatabilir.
{ "command": "action.devices.commands.EnableDisableNetworkProfile", "params": { "profile": "Kids", "enable": false } }
İlgili hatalar
Belirtilen ağ profili kontrol edilmeye çalışılırken bir hata oluştu.
Desteklenen değerler:
networkProfileNotRecognized
action.devices.commands.GetGuestNetworkPassword
Misafir ağı şifresini alın. PIN ile ikincil kullanıcı doğrulama kullanılmalıdır. Bu komutlar aracılığıyla diğer güvenlik cihazları devre dışı bırakılırsa kullanıcının ev güvenliği etkilenmiş olarak değerlendirilebilir.
Bu komut için aşağıdaki özellikler gerekir:{ "supportsGettingGuestNetworkPassword": true }
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
Özellik yok |
Örnekler
Misafir kablosuz ağ şifremi göster.
{ "command": "action.devices.commands.GetGuestNetworkPassword", "params": {} }
Sonuçlar
Sonuçlar | Tür | Açıklama |
---|---|---|
guestNetworkPassword |
String |
Zorunludur. Misafir ağının şifresi. |
Örnekler
Misafir kablosuz ağ şifremi göster.
{ "guestNetworkPassword": "123456" }
action.devices.commands.TestNetworkSpeed
Ağ indirme ve yükleme hızını test edin.
Bu komut için aşağıdaki özellikler gerekir:{ "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true }
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
testDownloadSpeed |
Boole |
Zorunludur. İndirme hızının test edilmesinin gerekip gerekmediğini gösterir. |
testUploadSpeed |
Boole |
Zorunludur. Yükleme hızının test edilmesinin gerekip gerekmediğini belirtir. |
followUpToken |
String |
Zorunludur. Takip yanıtı için Google tarafından sağlanan jeton. |
Örnekler
Kablosuz bağlantı hızı nedir?
{ "command": "action.devices.commands.TestNetworkSpeed", "params": { "testDownloadSpeed": true, "testUploadSpeed": true, "followUpToken": "123" } }
İlgili hatalar
Hız testi istenirken bir hata oluştu.
Desteklenen değerler:
networkSpeedTestInProgress
Yanıtlar
Bu özelliğe sahip cihazlar, EXECUTE
işleminin bir parçası olarak aşağıdaki takip yanıtı yükünü döndürebilir. Takip yanıtlarının uygulanması hakkında daha fazla bilgi edinmek için Akıllı ev İşlemleri bildirimleri başlıklı makaleyi inceleyin.
Yük aşağıdakilerden birini içerir:
Başarı: networkDownloadSpeedMbps
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
String |
Zorunludur. Orijinal EXECUTE isteğinde sağlanan jeton. |
status |
String |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
networkDownloadSpeedMbps |
Number |
Zorunludur. Saniyede megabit cinsinden ölçülen ağ indirme hızı. |
Başarı: networkUploadSpeedMbps
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
String |
Zorunludur. Orijinal EXECUTE isteğinde sağlanan jeton. |
status |
String |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
networkUploadSpeedMbps |
Number |
Zorunludur. Saniyede megabit cinsinden ölçülen ağ yükleme hızı. |
Başarı: networkDownloadSpeedMbps ve networkUploadSpeedMbps
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
String |
Zorunludur. Orijinal EXECUTE isteğinde sağlanan jeton. |
status |
String |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
networkDownloadSpeedMbps |
Number |
Zorunludur. Saniyede megabit cinsinden ölçülen ağ indirme hızı. |
networkUploadSpeedMbps |
Number |
Zorunludur. Saniyede megabit cinsinden ölçülen ağ yükleme hızı. |
Hata
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
String |
Zorunludur. Orijinal EXECUTE isteğinde sağlanan jeton. |
status |
String |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
errorCode |
String |
Zorunludur. Değer, bu özelliğe ait herhangi bir hata kodu olabilir (örneğin, |
Örnekler
Kablosuz bağlantı hızı nedir? (takip için verilecek yanıt)
{ "NetworkControl": { "priority": 0, "followUpResponse": { "status": "SUCCESS", "networkDownloadSpeedMbps": 23.3, "networkUploadSpeedMbps": 10.2, "followUpToken": "1234" } } }
Kablosuz bağlantı hızı nedir? (hatalı takip yanıtı)
{ "NetworkControl": { "priority": 0, "followUpResponse": { "status": "FAILURE", "errorCode": "transientError", "followUpToken": "1234" } } }
Cihaz ERRORS
Hataların ve istisnaların tam listesine bakın.Belirtilen ağ profili kontrol edilmeye çalışılırken bir hata oluştu.
Desteklenen değerler:
networkProfileNotRecognized
Hız testi istenirken bir hata oluştu.
Desteklenen değerler:
networkSpeedTestInProgress