Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Akıllı Ev Ağ Kontrolü Kontrol Şeması

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

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC niyetlerini 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ştirilmişse doğru değerine 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 komutu aracılığıyla alınabiliyorsa doğru değerine ayarlanır.

networkProfiles Dizi

Desteklenen ağ profili adlarını belirtir.

[item, ...] Dize

İlgili cihaz grubunu 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 değeri "true" olarak ayarlayın.

supportsNetworkUploadSpeedTest Boole

(Varsayılan: false)

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

Örnekler

Misafir ağını, profillerini ve hız testini destekleyen ağ cihazı.

{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true,
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true,
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true,
  "supportsGettingGuestNetworkPassword": true,
  "networkProfiles": [
    "kids"
  ]
}

Cihaz durumu

Bu özelliğe sahip cihazlar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY niyetlerini 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 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ı cihazların sayısı.

networkUsageMB Number

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

networkUsageLimitMB Number

MB cinsinden ağ kullanım sınırı (megabayt). Ağ kullanım sınırı mevcut fatura dönemidir.

networkUsageUnlimited Boole

Ağ kullanımının sınırsız olup olmadığı. Bu cihaz, true olarak 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 (saniyedeki megabit) indirme hızı.

unixTimestampSec Integer

Son ağ indirme hızı testinin çalıştırıldığı zamanın 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 (saniyedeki megabit) yükleme hızı.

unixTimestampSec Integer

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 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, söz konusu profilin ilgili durumu olmalıdır. 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/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ğı 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
}

"Child" ağ profili devre dışı bırakılan cihaz.

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

Cihaz FTC'leri

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE niyetlerini 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ğrulaması kullanılmalıdır. Diğer güvenlik cihazları bu komutlar aracılığıyla 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 Tür Açıklama
enable Boole

Zorunludur.

Misafir ağını etkinleştirmek için "true", misafir ağını devre dışı bırakmak için "false" (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. Diğer güvenlik cihazları bu komutlar aracılığıyla 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 Tür Açıklama
profile Dize

Zorunludur.

networkProfiles özelliğindeki profil adı.

enable Boole

Zorunludur.

Profili etkinleştirmek için Doğru, profili devre dışı bırakmak için Yanlış

Ö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. Diğer güvenlik cihazları bu komutlar aracılığıyla 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 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 Dize

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 aşağıdaki özellikleri gerektirir:
{
  "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 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 istenirken 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ını yükleyebilir. Takip yanıtlarını uygulama hakkında daha fazla bilgi için Akıllı ev işlemleri bildirimleri bölümüne bakın.

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

Başarılı: networkDownloadSpeedMbps

Alanlar Tür Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal Yürütme 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 Tür Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal Yürütme 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 Tür Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal Yürütme 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 Tür Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal Yürütme 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 (ör. transientError).

Örnekler

Kablosuz bağlantı hızı nedir? (devam eden 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 istenirken hata oluştu.

Desteklenen değerler:

networkSpeedTestInProgress