Akıllı Ev NetworkControl Özellik Şeması

action.devices.traits.NetworkControl - Bu özellik, ağ verilerinin raporlanmasını ve ağa özel işlemler gerçekleştirilmesini destekleyen cihazlara aittir.

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar aşağıdakileri bildirebilir özellikleri SYNC işleminin bir parçası olarak kullanılabilir. Öğrenmek için SYNC amacını işleme hakkında daha fazla bilgi edinin. Niyet karşılama.

Özellikler Tür Açıklama
supportsEnablingGuestNetwork Boole

(Varsayılan: false)

Misafir ağı etkinleştirilebiliyorsa doğru değerine ayarlayın.
supportsDisablingGuestNetwork Boole

(Varsayılan: false)

Misafir ağı devre dışı bırakılabiliyorsa değeri doğru olarak ayarlayın.
supportsGettingGuestNetworkPassword Boole

(Varsayılan: false)

Misafir ağ şifresi GetGuestNetworkPassword komutu kullanılarak alınabiliyorsa doğru olarak ayarlayın.
networkProfiles Dizi

Desteklenen ağ profili adlarını belirtir.
[item, ...] String

Bir grup ilgili cihazı temsil eden ağ profilinin adı.
supportsEnablingNetworkProfile Boole

(Varsayılan: "false")

Ağ profilleri etkinleştirilebiliyorsa doğru değerine ayarlayın.
supportsDisablingNetworkProfile Boole

(Varsayılan: "false")

Ağ profilleri devre dışı bırakılabiliyorsa doğru değerine ayarlayın.
supportsNetworkDownloadSpeedTest Boole

(Varsayılan: false)

İndirme hızı testi çalıştırılabiliyorsa doğru değerine ayarlanır.
supportsNetworkUploadSpeedTest Boole

(Varsayılan: false)

Yükleme hız testi yürütülebiliyorsa değeri doğru olarak 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 tüzel kişiler aşağıdaki durumları bildirebilir QUERY işleminin bir parçası olarak gösterilir. Öğrenmek için QUERY amacını işleme hakkında daha fazla bilgi edinin. Niyet karşılama.

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 Tamsayı

Ağa bağlı cihazların sayısı.
networkUsageMB Number

MB (megabayt) cinsinden ağ kullanımı. Ağ kullanımı, geçerli fatura dönemi içinde olabilir. Bu nedenle, fatura dönemine ait ağ kullanım sınırına göre bu durumu izlemek yararlı olabilir.
networkUsageLimitMB Number

MB (megabayt) cinsinden ağ kullanım sınırı. Ağ kullanım sınırı, geçerli fatura dönemi içinde olmalıdır.
networkUsageUnlimited Boole

Ağ kullanımının sınırsız olup olmadığı. Bu değer, doğru değerine ayarlanırsa cihaz durumu networkUsageLimitMB değeriyle yoksayı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 (saniyedeki megabit sayısı) cinsinden indirme hızı.
unixTimestampSec Tamsayı

Son ağ indirme hızı testinin çalıştırıldığı zamanın Unix zaman damgası (Unix Epoch'tan bu yana geçen saniye sayısı).
status String

Son ağ indirme hızı testinin başarılı mı yoksa başarısız mı olduğunu belirtir.

Desteklenen değerler:

SUCCESS
FAILURE
lastNetworkUploadSpeedTest Nesne

En son ağ yükleme hız testinin sonuçlarını içerir.
uploadSpeedMbps Number

Son ağ hız testinin Mb/sn (saniyedeki megabit sayısı) cinsinden yükleme hızı.
unixTimestampSec Tamsayı

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 String

Son ağ yükleme hız testinin başarılı mı yoksa başarısız mı olduğunu belirtir.

Desteklenen değerler:

SUCCESS
FAILURE
networkSpeedTestInProgress Boole

(Varsayılan: false)

Şu anda hız testi yapılıp yapılmadığı.
networkProfilesState Nesne

Ağ profillerinin durumu. Bu üst düzey nesne, anahtarın networkProfiles özelliğinde listelenen ağ profillerinden birinin adı olduğu anahtar/değer çiftlerini içermelidir ve değerin, söz konusu profile karşılık gelen durumu olması gerekir.
<string> Nesne

Tek bir ağ profilinin durumunu depolayan nesne. anahtarının değeri, networkProfiles özelliğindeki ağ profillerinden birinin adı olmalıdır.
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 ağ bağlantısı 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ğı ve devam eden hız testi bulunan cihaz.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "networkSpeedTestInProgress": true
}

"Çocuk" özellikli cihaz networkProfile devre dışı bırakıldı.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "networkProfilesState": {
    "parents": {
      "enabled": true
    },
    "kids": {
      "enabled": false
    }
  }
}

Cihaz COMMANDS

Bu özelliğe sahip cihazlar aşağıdakilere yanıt verebilir komutlarını EXECUTE işleminin bir parçası olarak kullanabilirsiniz. Öğrenmek için EXECUTE amacını işleme hakkında daha fazla bilgi edinin. Niyet karşılama.

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. Bu komutlar aracılığıyla diğer güvenlik cihazları devre dışı bırakılırsa kullanıcının ev güvenliği bundan 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 doğru, misafir ağını devre dışı bırakmak için false (yanlış) değerine sahiptir.

Örnekler

Misafir ağını etkinleştirin.

{
  "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. Bu komutlar aracılığıyla diğer güvenlik cihazları devre dışı bırakılırsa kullanıcının ev güvenliği bundan etkilenebilir.

Bu komut aşağıdaki özellikleri gerektirir: 
{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}
.

Parametreler

Parametreler Tür Açıklama
profile String

Zorunludur.

networkProfiles özelliğindeki profil adı.
enable Boole

Zorunludur.

Profili etkinleştirmek için doğru, profili devre dışı bırakmak için false değerine ayarlayın.

Örnekler

Çocuklar için interneti kapatın.

{
  "command": "action.devices.commands.EnableDisableNetworkProfile",
  "params": {
    "profile": "Kids",
    "enable": false
  }
}

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ğrulaması 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 bundan 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 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ızları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 edilmesi gerekip gerekmediğini gösterir.
testUploadSpeed Boole

Zorunludur.

Yükleme hızının test edilmesi 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"
  }
}

Hız testi istenmeye çalışılırken bir hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress
ziyaret edin.

Yanıt yanıtları

Bu özelliğe sahip cihazlar aşağıdaki sonuçları döndürebilir: EXECUTE işleminin bir parçası olarak takip yanıtı yükü. Öğrenmek için daha fazla bilgi için bkz. Akıllı ev işlemleri için bildirimler.

Yük aşağıdakilerden birini içerir:

Başarı: networkDownloadSpeedMbps

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

İlk EXECUTE isteğinde sağlanan jeton.
status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkDownloadSpeedMbps Number

Zorunludur.

Saniye başına megabit cinsinden ölçülen ağ indirme hızı.

Başarı: networkUploadSpeedMbps

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

İlk EXECUTE isteğinde sağlanan jeton.
status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkUploadSpeedMbps Number

Zorunludur.

Saniye başına megabit cinsinden ölçülen ağ yükleme hızı.

Başarılı: networkDownloadSpeedMbps ve networkUploadSpeedMbps

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

İlk EXECUTE isteğinde sağlanan jeton.
status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkDownloadSpeedMbps Number

Zorunludur.

Saniye başına megabit cinsinden ölçülen ağ indirme hızı.
networkUploadSpeedMbps Number

Zorunludur.

Saniye başına megabit cinsinden ölçülen ağ yükleme hızı.

Hata

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

İlk EXECUTE isteğinde sağlanan jeton.
status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

FAILURE
errorCode String

Zorunludur.

Değer, bu özelliğe yönelik herhangi bir hata kodu olabilir (örneğin, transientError).

Örnekler

Kablosuz bağlantı hızı nedir? (sonraki 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 ERRORS

Tam listeye göz atın: hataları ve istisnaları ortadan kaldırın.

Belirtilen ağ profili kontrol edilmeye çalışılırken bir hata oluştu.

Desteklenen değerler:

networkProfileNotRecognized

Hız testi istenmeye çalışılırken bir hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress