Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Akıllı Ev NetworkControl Özellik Şeması

action.devices.traits.NetworkControl - Bu özellik, ağ verilerinin raporlanmasını ve ağa özel işlemlerin gerçekleştirilmesini 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 için Amaç karşılama bölümüne bakın.

Özellikler Type Açıklama
supportsEnablingGuestNetwork Boole

(Varsayılan: false)

Misafir ağı etkinleştirilebiliyorsa doğru değerine ayarlanır.
supportsDisablingGuestNetwork Boole

(Varsayılan: false)

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

(Varsayılan: false)

Misafir ağı şifresini GetGuestNetworkPassword komutu aracılığıyla edinilebiliyorsa doğru değerine ayarlayın.
networkProfiles Dizi

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

İlgili cihaz grubunu temsil eden ağ profilinin adı.
supportsEnablingNetworkProfile Boole

(Varsayılan: "false")

Ağ profilleri etkinleştirilebiliyorsa doğru değerine ayarlanır.
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 çalıştırılabiliyorsa doğru değerine ayarlanır.

Ö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 STATUS

Bu özelliğe sahip varlıklar, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

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

MB cinsinden ağ kullanımı (megabayt). Ağ kullanımı, geçerli fatura dönemi içindedir. Bu, fatura dönemi ağ kullanım sınırıyla ilgili olarak izlenmesi yararlı olabilir.
networkUsageLimitMB Number

MB cinsinden ağ kullanım sınırı (megabayt). Ağ kullanım sınırı mevcut fatura dönemine ait.
networkUsageUnlimited Boole

Ağ kullanımının sınırsız olup olmadığı. Bu değer, doğru değerine 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 (saniye cinsinden megabit) indirme hızı.
unixTimestampSec Integer

Son ağ indirme hızı testinin çalıştırıldığı 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:

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. cinsinden (saniye cinsinden megabit) yükleme hızı.
unixTimestampSec Integer

Son ağ yükleme hızı testinin çalıştırıldığı Unix zaman damgası (Unix Epoch'tan beri 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:

SUCCESS
FAILURE
networkSpeedTestInProgress Boole

(Varsayılan: false)

Ş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 networkProfiles özelliğinde listelenen ağ profillerinden birinin adı ve değer, profilin ilgili durumu olması gereken anahtar/değer çiftlerini içermelidir.
<string> Nesne

Bağımsız 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/devre dışı olma 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
}

"kids" ağ profili devre dışı olan cihaz.

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

Cihaz Komisyonları

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 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. Bu komutlar aracılığıyla diğer güvenlik cihazları 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 Type Açıklama
enable Boole

Zorunludur.

Misafir ağını etkinleştirmek için doğru, misafir ağını devre dışı bırakmak için yanlış değerini seçin.

Ö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 bu durumdan etkilenebilir.

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

Parametreler

Parametreler Type Açıklama
profile Dize

Zorunludur.

networkProfiles özelliğindeki profil adı.
enable Boole

Zorunludur.

True ile değiştirin.

Ö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 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 bu durumdan etkilenebilir.

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

Parametreler

Parametreler Type Açıklama

Özellik yok

Örnekler

Misafir kablosuz ağı şifremi göster.

{
  "command": "action.devices.commands.GetGuestNetworkPassword",
  "params": {}
}

Sonuçlar

Sonuçlar Type Açıklama
guestNetworkPassword Dize

Zorunludur.

Misafir ağının şifresidir.

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

Hız testi isteğinde bulunmaya çalışılırken bir 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ünü döndürebilir. Takip yanıtlarını uygulama hakkında daha fazla bilgi için Akıllı ev İşlemleri bildirimlerine bakın.

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

Başarılı: networkDownloadSpeedMbps

Alanlar Type Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlanır.
status Dize

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkDownloadSpeedMbps Number

Zorunludur.

Megabit/saniye olarak ölçülen ağ indirme hızı.

Başarılı: networkUploadSpeedMbps

Alanlar Type Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlanır.
status Dize

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
networkUploadSpeedMbps Number

Zorunludur.

Megabit/saniye olarak ölçülen ağ yükleme hızı.

Başarılı: networkDownloadSpeedMbps ve networkUploadSpeedMbps

Alanlar Type Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlanır.
status Dize

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
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 Type Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlanır.
status Dize

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

FAILURE
errorCode Dize

Zorunludur.

Değer, bu özellik için herhangi bir hata kodu olabilir. Örneğin, 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ı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 isteğinde bulunmaya çalışılırken bir hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress