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: false)

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

(Varsayılan: false)

Misafir ağı devre dışı bırakılabiliyorsa true olarak ayarlayın.
supportsGettingGuestNetworkPassword Boole

(Varsayılan: false)

Misafir ağ şifresi GetGuestNetworkPassword komutuyla alınabiliyorsa true olarak ayarlanır.
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: "false")

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

(Varsayılan: "false")

Ağ profilleri devre dışı bırakılabiliyorsa true olarak ayarlayın.
supportsNetworkDownloadSpeedTest Boole

(Varsayılan: false)

İndirme hızı testi çalıştırılabiliyorsa true (doğru) değerine ayarlayın.
supportsNetworkUploadSpeedTest Boole

(Varsayılan: false)

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:

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 (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:

SUCCESS
FAILURE
networkSpeedTestInProgress Boole

(Varsayılan: false)

Ş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 networkProfiles özelliğinde listelenen ağ profillerinden birinin adı olduğu ve değerin de bu profilin karşılık gelen durumu olması gereken anahtar/değer çiftleri içermelidir.
<string> Nesne

Tek bir ağ profilinin durumunu depolayan bir 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 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.

networkProfiles özelliğindeki profil adı.
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
  }
}

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"
  }
}

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:

SUCCESS
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:

SUCCESS
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:

SUCCESS
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:

FAILURE
errorCode String

Zorunludur.

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

Ö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