Akıllı Ev NetworkControl Özelliği Şeması

action.devices.traits.NetworkControl: Bu özellik, ağ verilerini raporlamayı ve ağa özgü işlemleri gerçekleştirmeyi destekleyen cihazlara aittir.

CİHAZ ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Ö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 doğru değerine ayarlanır.
supportsGettingGuestNetworkPassword Boole

(Varsayılan: false)

Misafir ağı şifresi GetGuestNetworkPassword komutu aracılığıyla alınabiliyorsa doğru değerine 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 doğru değerine ayarlayın.
supportsNetworkDownloadSpeedTest Boole

(Varsayılan: false)

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

(Varsayılan: false)

Yükleme hızı testi çalıştırılabilirse doğru değerine ayarlanır.

Ö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 intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent 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

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ı cihaz sayısı.
networkUsageMB Number

MB (megabayt) cinsinden ağ kullanımı. Ağ kullanımı, mevcut faturalandırma dönemindedir. Bu, faturalandırma dönemi ağ kullanım sınırıyla ilgili olarak izlemek için yararlı olabilir.
networkUsageLimitMB Number

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

Ağ kullanımının sınırsız olup olmadığı. Bu ayar true (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 testi için indirme hızı (Mb/sn. cinsinden).
unixTimestampSec Tamsayı

Son ağ indirme hızı testinin yapıldığı Unix zaman damgası (Unix sıfır zamanından itibaren saniye sayısı).
status String

Son ağ indirme hızı testinin başarılı olup olmadığını 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 testi için Mb/sn. (saniyede megabit) cinsinden yükleme hızı.
unixTimestampSec Tamsayı

Son ağ yükleme hızı testinin yapıldığı Unix zaman damgası (Unix sıfır zamanından itibaren saniye sayısı).
status String

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

Desteklenen değerler:

SUCCESS
FAILURE
networkSpeedTestInProgress Boole

(Varsayılan: false)

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

Ağ profillerinin durumu. Bu üst düzey nesne, networkProfiles özelliğinde listelenen ağ profillerinden birinin adının anahtar, ilgili profilin durumunun ise değer olduğu anahtar/değer çiftleri içermelidir.
<string> Nesne

Tek bir ağ profilinin durumunu saklayan 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ı 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 sahip 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" networkProfile özelliği 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 intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

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ğinin etkilendiği kabul edilebilir.

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

Parametreler

Parametreler Tür Açıklama
enable Boole

Zorunludur.

Misafir ağını etkinleştirmek için doğru, devre dışı bırakmak için 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. Bu komutlar aracılığıyla diğer güvenlik cihazları 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 gereklidir: 
{
  "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, devre dışı bırakmak için yanlış değerini girin.

Ö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ğinin etkilendiği kabul edilebilir.

Bu komut için aşağıdaki özellikler gereklidir: 
{
  "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 gereklidir: 
{
  "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 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 isteğinde bulunurken hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress

Takip yanıtları

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki takip yanıtı yükü 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ı makaleyi inceleyin.

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

Başarılı: 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ılı: 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ılı: 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 özellik için herhangi bir hata kodu olabilir (ör. transientError).

Örnekler

Kablosuz bağlantı hızı nedir? (takip 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ızlıkla ilgili 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 bir hata oluştu.

Desteklenen değerler:

networkProfileNotRecognized

Hız testi isteğinde bulunurken hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress