Smart Home NetworkControl Trait Şeması

action.devices.traits.NetworkControl: Bu özellik, ağ verilerinin raporlanmasını ve ağa özgü işlemlerin yapılmasını destekleyen cihazlara aittir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
supportsEnablingGuestNetwork Boole

(Varsayılan: false)

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

(Varsayılan: false)

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

(Varsayılan: false)

Misafir ağı şifresi GetGuestNetworkPassword komutuyla alınabiliyorsa doğru olarak ayarlayın.
networkProfiles Array

Desteklenen ağ profili adlarını gösterir.
[item, ...] String

Birbiriyle ilişkili cihaz grubunu temsil eden ağ profilinin adı.
supportsEnablingNetworkProfile Boole

(Varsayılan: "false")

Ağ profilleri etkinleştirilebiliyorsa true olarak 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 yapılabiliyorsa true olarak ayarlayın.
supportsNetworkUploadSpeedTest Boole

(Varsayılan: false)

Yükleme hızı testi çalıştırılabiliyorsa true olarak ayarlayın.

Örnekler

Misafir ağı, 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 DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
networkEnabled Boole

Ana ağın etkin olup olmadığı.
networkSettings Nesne

Ana ağın SSID'sini içerir.
ssid String

Zorunlu.

Ağ SSID'si.
guestNetworkEnabled Boole

Misafir ağının etkin olup olmadığı
guestNetworkSettings Nesne

Misafir ağının SSID'sini içerir.
ssid String

Zorunlu.

Ağ SSID'si.
numConnectedDevices Integer

Ağa bağlı cihaz sayısı.
networkUsageMB Number

MB (megabayt) cinsinden ağ kullanımı. Ağ kullanımı, mevcut fatura dönemi içindedir. Bu bilgi, fatura dönemi ağ kullanım sınırını izlemek için 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çinde olmalıdır.
networkUsageUnlimited Boole

Ağ kullanımının sınırsız olup olmadığı. Bu politika doğru değerine ayarlanırsa cihaz durumu networkUsageLimitMB 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 (saniyede megabit) cinsinden indirme hızı.
unixTimestampSec Integer

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

Son ağ indirme hızı testinin başarılı olup olmadığını 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 (saniyede megabit) 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 bu yana geçen saniye sayısı).
status String

Son ağ yükleme hızı testinin başarılı olup olmadığını gösterir.

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 ve değerin bu profilin karşılık gelen durumu olması gereken anahtar/değer çiftlerini 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 etkin/devre dışı durumu.

Örnekler

Etkin bir ağa bağlı cihaz

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

Etkin bir ağa sahip 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ğa bağlı 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
}

"kids" ağ profili devre dışı bırakılmış cihaz.

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

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.EnableDisableGuestNetwork

Misafir ağını etkinleştirme veya devre dışı bırakma. PIN ile ikincil kullanıcı doğrulaması kullanılmalıdır. Diğer güvenlik cihazları bu komutlarla devre dışı bırakılırsa kullanıcının ev güvenliğinin etkilendiği düşünülebilir.

Bu komut için aşağıdaki özellikler gerekir: 
{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true
}

Parametreler

Parametreler Tür Açıklama
enable Boole

Zorunlu.

Misafir ağını etkinleştirmek için true, devre dışı bırakmak için false.

Ö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. Diğer güvenlik cihazları bu komutlarla devre dışı bırakılırsa kullanıcının ev güvenliğinin etkilendiği kabul edilebilir.

Bu komut için aşağıdaki özellikler gerekir: 
{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}

Parametreler

Parametreler Tür Açıklama
profile String

Zorunlu.

networkProfiles özelliğindeki profil adı.
enable Boole

Zorunlu.

Profili etkinleştirmek için true, devre dışı bırakmak için false.

Örnekler

Çocuklar için interneti kapatın.

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

Belirtilen ağ profilini kontrol etmeye çalışı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. Diğer güvenlik cihazları bu komutlarla devre dışı bırakılırsa kullanıcının ev güvenliğinin etkilendiği kabul edilebilir.

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

Zorunlu.

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

Zorunlu.

İndirme hızının test edilip edilmeyeceğini gösterir.
testUploadSpeed Boole

Zorunlu.

Yükleme hızının test edilip edilmeyeceğini gösterir.
followUpToken String

Zorunlu.

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 isteğinde bulunmaya çalışırken bir hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress

Takip yanıtları

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki takip yanıtı yükünü döndürebilir. Takip yanıtlarını uygulama hakkında daha fazla bilgi edinmek için Akıllı ev işlemleri için bildirimler başlıklı makaleye bakın.

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

Başarılı: networkDownloadSpeedMbps

Alanlar Tür Açıklama
followUpToken String

Zorunlu.

Orijinal EXECUTE isteğinde sağlanan jeton.
status String

Zorunlu.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkDownloadSpeedMbps Number

Zorunlu.

Saniyede megabit cinsinden ölçülen ağ indirme hızı.

Başarılı: networkUploadSpeedMbps

Alanlar Tür Açıklama
followUpToken String

Zorunlu.

Orijinal EXECUTE isteğinde sağlanan jeton.
status String

Zorunlu.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkUploadSpeedMbps Number

Zorunlu.

Ağın saniyede megabit cinsinden ölçülen yükleme hızı.

Başarı: networkDownloadSpeedMbps ve networkUploadSpeedMbps

Alanlar Tür Açıklama
followUpToken String

Zorunlu.

Orijinal EXECUTE isteğinde sağlanan jeton.
status String

Zorunlu.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkDownloadSpeedMbps Number

Zorunlu.

Saniyede megabit cinsinden ölçülen ağ indirme hızı.
networkUploadSpeedMbps Number

Zorunlu.

Ağın saniyede megabit cinsinden ölçülen yükleme hızı.

Hata

Alanlar Tür Açıklama
followUpToken String

Zorunlu.

Orijinal EXECUTE isteğinde sağlanan jeton.
status String

Zorunlu.

İsteğin sonucu.

Desteklenen değerler:

FAILURE
errorCode String

Zorunlu.

Değer, bu özellik için herhangi bir hata kodu olabilir (örneğin, transientError).

Örnekler

Wi-Fi hızı nedir? (takip yanıtı)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "networkDownloadSpeedMbps": 23.3,
      "networkUploadSpeedMbps": 10.2,
      "followUpToken": "1234"
    }
  }
}

Wi-Fi hızı nedir? (hata içeren takip yanıtı)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "transientError",
      "followUpToken": "1234"
    }
  }
}

Cihaz HATALARI

Hatalar ve istisnalar listesinin tamamını inceleyin.

Belirtilen ağ profilini kontrol etmeye çalışırken bir hata oluştu.

Desteklenen değerler:

networkProfileNotRecognized

Hız testi isteğinde bulunmaya çalışırken bir hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress