Schéma du Trait de chaîne pour la maison connectée

action.devices.traits.Channel : cette caractéristique appartient aux appareils compatibles avec les chaînes TV sur un appareil multimédia.

Les canaux disponibles doivent être partagés sous forme de liste, par utilisateur ou par appareil, lors de la synchronisation via l'attribut availableChannels. Cette liste doit comprendre toutes les principales chaînes ou chaînes populaires auxquelles l'utilisateur ou l'appareil est abonné. Pour garantir une latence de requête faible, nous vous recommandons de limiter la liste des canaux (à 30 canaux ou moins).

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
availableChannels Array

Obligatoire.

Liste d'objets décrivant les canaux multimédias disponibles pour cet appareil. Chaque élément décrit un canal que l'utilisateur peut sélectionner sur cet appareil.

[item, ...] Objet

Canal média disponible.

key String

Obligatoire.

Identifiant unique de cette chaîne. Non visible par les utilisateurs.

names Array

Obligatoire.

Liste des noms visibles par les utilisateurs pour cette chaîne.

[item, ...] String

Le nom de la chaîne

number String

Identifiant numérique facultatif pour ce canal.

commandOnlyChannels Booléen

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Report Report pour cette caractéristique.

Exemples

Appareil compatible avec deux canaux

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

Appareil STATES

Aucun.

Appareil COMMANDS

Les appareils disposant de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.selectChannel

Définissez le canal actuel sur une valeur spécifique.

Paramètres

La charge utile contient l'un des éléments suivants:

Sélectionner la chaîne par ID

Paramètres Type Description
channelCode String

Obligatoire.

Identifiant unique du canal demandé, correspondant à l'un des availableChannels.

channelName String

Nom convivial de la chaîne demandée.

channelNumber String

Identifiant numérique du canal demandé.

Sélectionner le canal par numéro

Paramètres Type Description
channelNumber String

Obligatoire.

Identifiant numérique du canal demandé.

Exemples

Passer à KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

Passer au canal 3

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

Une erreur s'est produite lors de la sélection d'une nouvelle chaîne sur l'appareil.

Valeurs acceptées :

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Ajustez le canal actuel selon un montant relatif.

Paramètres

Paramètres Type Description
relativeChannelChange Entier

Obligatoire.

Nombre de canaux à augmenter ou à réduire.

Exemples

Passer à la chaîne suivante

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

Revenir à la chaîne précédente

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

Une erreur s'est produite lors du réglage de la version de l'appareil.

Valeurs acceptées :

channelSwitchFailed

action.devices.commands.returnChannel

Revenir au canal précédent/précédent de l'utilisateur.

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Revenir à la dernière chaîne

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

Une erreur s'est produite lors du retour au dernier canal de l'appareil.

Valeurs acceptées :

channelSwitchFailed

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.