Akıllı Ev Ağ Kontrolü Kontrol Şeması
action.devices.traits.NetworkControl
: Bu özellik, ağ verilerinin raporlanmasını ve ağa özel işlemlerin gerçekleştirilmesini destekleyen cihazlara aittir.
Cihaz ÖZELLİKLERİ
Bu özelliğe sahip cihazlar, SYNC
işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC
niyetlerini 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ştirilmişse doğru değerine ayarlayın. |
supportsDisablingGuestNetwork |
Boole |
(Varsayılan: Misafir ağı devre dışı bırakılabiliyorsa doğru olarak ayarlayın. |
supportsGettingGuestNetworkPassword |
Boole |
(Varsayılan: Misafir ağı şifresi |
networkProfiles |
Dizi |
Desteklenen ağ profili adlarını belirtir. |
[item, ...] |
Dize |
İlgili cihaz grubunu 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 doğru değerine ayarlayın. |
supportsNetworkDownloadSpeedTest |
Boole |
(Varsayılan: İndirme hızı testi çalıştırılabiliyorsa değeri "true" olarak ayarlayın. |
supportsNetworkUploadSpeedTest |
Boole |
(Varsayılan: Yükleme hızı testi çalıştırılabiliyorsa değeri "true" olarak ayarlayın. |
Örnekler
Misafir ağını, profillerini ve hız testini destekleyen ağ cihazı.
{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true, "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true, "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true, "supportsGettingGuestNetworkPassword": true, "networkProfiles": [ "kids" ] }
Cihaz durumu
Bu özelliğe sahip cihazlar, QUERY
işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY
niyetlerini 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 |
Dize |
Zorunludur. Ağ SSID'si. |
guestNetworkEnabled |
Boole |
Misafir ağının etkin olup olmadığı. |
guestNetworkSettings |
Nesne |
Misafir ağının SSID'sini içerir. |
ssid |
Dize |
Zorunludur. Ağ SSID'si. |
numConnectedDevices |
Integer |
Ağa bağlı cihazların sayısı. |
networkUsageMB |
Number |
MB cinsinden ağ kullanımı (megabayt). Ağ kullanımı, geçerli fatura dönemi içindedir ve fatura dönemi ağ kullanım sınırıyla ilgili olarak izleme açısından yararlı olabilir. |
networkUsageLimitMB |
Number |
MB cinsinden ağ kullanım sınırı (megabayt). Ağ kullanım sınırı mevcut fatura dönemidir. |
networkUsageUnlimited |
Boole |
Ağ kullanımının sınırsız olup olmadığı. Bu cihaz, true olarak ayarlanırsa networkUseLimitMB cihaz durumu 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. cinsinden (saniyedeki megabit) indirme hızı. |
unixTimestampSec |
Integer |
Son ağ indirme hızı testinin çalıştırıldığı zamanın Unix zaman damgası (Unix Epoch'tan beri geçen saniye sayısı). |
status |
Dize |
Son ağ indirme hızı testinin başarılı veya başarısız olduğunu belirtir. 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. cinsinden (saniyedeki megabit) yükleme hızı. |
unixTimestampSec |
Integer |
Son ağ yükleme hızı testinin çalıştırıldığı zamanın Unix zaman damgası (Unix Epoch'tan bu yana geçen saniye sayısı). |
status |
Dize |
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 çalıştırılıp çalıştırı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/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ı olan 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ğı olan 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 }
"Child" ağ profili devre dışı bırakılan cihaz.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "networkProfilesState": { "parents": { "enabled": true }, "kids": { "enabled": false } } }
Cihaz FTC'leri
Bu özelliğe sahip cihazlar, EXECUTE
işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE
niyetlerini 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ğrulaması kullanılmalıdır. Diğer güvenlik cihazları bu komutlar aracılığıyla devre dışı bırakılırsa kullanıcının ev güvenliği bu durumdan etkilenebilir.
Bu komut aşağıdaki özellikleri gerektirir:{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true }
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
enable |
Boole |
Zorunludur. Misafir ağını etkinleştirmek için "true", misafir ağını devre dışı bırakmak için "false" (yanlış) değerini girin. |
Örnekler
Misafir ağını açın.
{ "command": "action.devices.commands.EnableDisableGuestNetwork", "params": { "enable": true } }
action.devices.commands.EnableDisableNetworkProfile
Bir ağ profilini etkinleştirme veya devre dışı bırakma. PIN ile ikincil kullanıcı doğrulaması kullanılmalıdır. Diğer güvenlik cihazları bu komutlar aracılığıyla devre dışı bırakılırsa kullanıcının ev güvenliği bu durumdan etkilenebilir.
Bu komut aşağıdaki özellikleri gerektirir:{ "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true }
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
profile |
Dize |
Zorunludur.
|
enable |
Boole |
Zorunludur. Profili etkinleştirmek için Doğru, profili devre dışı bırakmak için Yanlış |
Örnekler
Çocuklar için interneti kapatın.
{ "command": "action.devices.commands.EnableDisableNetworkProfile", "params": { "profile": "kids", "enable": false } }
İlgili hatalar
Belirtilen ağ profili kontrol edilmeye çalışılırken hata oluştu.
Desteklenen değerler:
networkProfileNotRecognized
action.devices.commands.GetGuestNetworkPassword
Misafir ağı şifresini alın. PIN ile ikincil kullanıcı doğrulaması kullanılmalıdır. Diğer güvenlik cihazları bu komutlar aracılığıyla devre dışı bırakılırsa kullanıcının ev güvenliği bu durumdan etkilenebilir.
Bu komut aşağıdaki özellikleri gerektirir:{ "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 |
Dize |
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 aşağıdaki özellikleri gerektirir:{ "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true }
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
testDownloadSpeed |
Boole |
Zorunludur. İndirme hızının test edilip edilmeyeceğini belirtir. |
testUploadSpeed |
Boole |
Zorunludur. Yükleme hızının test edilip edilmeyeceğini belirtir. |
followUpToken |
Dize |
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 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ını yükleyebilir. Takip yanıtlarını uygulama hakkında daha fazla bilgi için Akıllı ev işlemleri bildirimleri bölümüne bakın.
Yük, aşağıdakilerden birini içerir:
Başarılı: networkDownloadSpeedMbps
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
Dize |
Zorunludur. Jeton, orijinal Yürütme isteğinde sağlanır. |
status |
Dize |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
networkDownloadSpeedMbps |
Number |
Zorunludur. Megabit/saniye olarak ölçülen ağ indirme hızı. |
Başarılı: networkUploadSpeedMbps
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
Dize |
Zorunludur. Jeton, orijinal Yürütme isteğinde sağlanır. |
status |
Dize |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
networkUploadSpeedMbps |
Number |
Zorunludur. Megabit/saniye olarak ölçülen ağ yükleme hızı. |
Başarılı: networkDownloadSpeedMbps ve networkUploadSpeedMbps
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
Dize |
Zorunludur. Jeton, orijinal Yürütme isteğinde sağlanır. |
status |
Dize |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
networkDownloadSpeedMbps |
Number |
Zorunludur. Megabit/saniye olarak ölçülen ağ indirme hızı. |
networkUploadSpeedMbps |
Number |
Zorunludur. Megabit/saniye olarak ölçülen ağ yükleme hızı. |
Hata
Alanlar | Tür | Açıklama |
---|---|---|
followUpToken |
Dize |
Zorunludur. Jeton, orijinal Yürütme isteğinde sağlanır. |
status |
Dize |
Zorunludur. İsteğin sonucu. Desteklenen değerler:
|
errorCode |
Dize |
Zorunludur. Değer, bu özellik için herhangi bir hata kodu olabilir (ör. |
Örnekler
Kablosuz bağlantı hızı nedir? (devam eden yanıt)
{ "NetworkControl": { "priority": 0, "followUpResponse": { "status": "SUCCESS", "networkDownloadSpeedMbps": 23.3, "networkUploadSpeedMbps": 10.2, "followUpToken": "1234" } } }
Kablosuz bağlantı hızı nedir? (başarısız olan takip yanıtı)
{ "NetworkControl": { "priority": 0, "followUpResponse": { "status": "FAILURE", "errorCode": "transientError", "followUpToken": "1234" } } }
Cihaz HATALARI
Hataların ve istisnaların tam listesini inceleyin.Belirtilen ağ profili kontrol edilmeye çalışılırken hata oluştu.
Desteklenen değerler:
networkProfileNotRecognized
Hız testi istenirken hata oluştu.
Desteklenen değerler:
networkSpeedTestInProgress