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.

Smart Home TransportControl Özellik Şeması

action.devices.traits.TransportControl: Bu özellik, medya oynatmayı kontrol edebilen cihazlar (örneğin, duraklatılmış durumdayken müziği devam ettirmek) için kullanılır.

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 için Amaç karşılama bölümüne bakın.

Özellikler Tür Açıklama
transportControlSupportedCommands Dizi

Zorunludur.

Bu cihazda desteklenen taşıma kontrolü komutlarını açıklayan dize listesi.

[item, ...] Dize

Desteklenen komutlar.

Desteklenen değerler:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Örnekler

Oynatma komutlarını destekleyen cihaz

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

Cihaz StateS'i

Yok.

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 için Amaç karşılama bölümüne bakın.

action.devices.commands.mediaStop

Medya oynatmayı duraklat.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Parametre yok

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

action.devices.commands.mediaNext

Sonraki medya öğesine atla.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Parametre yok

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

action.devices.commands.mediaPrevious

Önceki medya öğesine atla.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Parametre yok

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

action.devices.commands.mediaPause

Medya oynatmayı duraklat.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Parametre yok

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

action.devices.commands.mediaResume

Medya oynatmayı devam ettir.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Parametre yok

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

action.devices.commands.mediaSeekRelative

Göreli bir konum arayın.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parametreler

Parametreler Tür Açıklama
relativePositionMs Integer

Zorunludur.

Aranacak milyon (ileri düzey int) veya geriye doğru (negatif int) miktarı (milisaniye cinsinden).

Örnekler

İleri sarma 10'lar

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

10 saniye geri sar

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

action.devices.commands.mediaSeekToPosition

Mutlak bir konum arayın.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parametreler

Parametreler Tür Açıklama
absPositionMs Integer

Zorunludur.

Aranacak mutlak konumun milyon saniyesi.

Örnekler

30 saniye sarf

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

Tekrar oynatma modunu ayarlayın.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parametreler

Parametreler Tür Açıklama
isOn Boole

Zorunludur.

Tekrar modu açmak için True (tekrar) modunu kapatmak için false (yanlış) değerini girin.

isSingle Boole

(Varsayılan: false)

Belirtilirse doğru, tek öğeli tekrar modun açılması anlamına gelir; yanlış ise normal tekrarlama modunun açılması anlamına gelir (ör. oynatma listesi).

Örnekler

Tekrarlanacağı gün

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true
  }
}

Tekrarlama modu

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": false
  }
}

Tek bir parçayı tekrarlama

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true,
    "isSingle": true
  }
}

action.devices.commands.mediaShuffle

Mevcut oynatma listesini karıştırın.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Parametre yok

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

action.devices.commands.mediaClosedCaptioningOn

Altyazıları açın.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametreler

Parametreler Tür Açıklama
closedCaptioningLanguage Dize

Altyazının dili veya yerel ayarı.

userQueryLanguage Dize

Kullanıcı sorgusu için dil veya yerel ayar.

Örnekler

İngilizce altyazıyı açma

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

Korece altyazıyı açma

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

Amerikan İngilizcesi kullanıcı sorgusu ile Korece altyazıyı açın

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

action.devices.commands.mediaClosedCaptioningOff

Altyazıları kapatın.

Bu komut aşağıdaki özellikleri gerektirir:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Altyazıyı kapatma

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

Cihaz ERRORS

Hataların ve istisnaların tam listesini inceleyin.