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 TransportControl İşlem Şeması

action.devices.traits.TransportControl: Bu özellik, medya oynatmayı kontrol edebilen cihazlarda (örneğin, duraklatılmışken müziği devam ettirmek) 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 edinmek için Amaç karşılama bölümüne bakın.

Özellikler Tür Açıklama
transportControlSupportedCommands Dizi

Zorunludur.

Bu cihazda desteklenen aktarım 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 durumu

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 edinmek 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.

Milisaniye cinsinden ileriye dönük (pozitif int) veya geriye doğru (negatif int) tutar.

Örnekler

10 saniye ileri sar

{
  "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 pozisyona gidin.

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

Parametreler

Parametreler Tür Açıklama
absPositionMs Integer

Zorunludur.

Aranacak mutlak konumun (milisaniye cinsinden) sayısı.

Örnekler

30 saniye ara

{
  "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.

Tekrarlama modunu etkinleştirmek için Doğru, tekrar modunu kapatmak için de yanlış

isSingle Boole

(Varsayılan: false)

Belirtilmişse "true", tek öğeli tekrar modunun etkinleştirilmesini, "false" normal normal modun (ör. oynatma listesi) açılması anlamına gelir.

Örnekler

Tekrar oynatma açık

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

Tekrarlama kapalı

{
  "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

Geçerli 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ı için dil veya yerel ayar

userQueryLanguage Dize

Kullanıcı sorgusu için kullanılan 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"
  }
}

Kullanıcı İngilizcesi dilinde ve Korece İngilizce altyazıyı açma

{
  "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 HATALARI

Hataların ve istisnaların tam listesini inceleyin.