cast.
Données de la requête INSERT de la file d'attente d'événements multimédias.
Constructeur
QueueInsertRequestData
new QueueInsertRequestData(items)
Paramètres |
|
|---|---|
|
items |
Tableau de valeurs non nulles cast.framework.messages.QueueItem Liste des éléments de la file d'attente. Le champ "itemId" des articles doit être vide, sans quoi la requête échouera et générera une erreur INVALID_PARAMS. Il est trié (le premier élément est lu en premier). La valeur ne doit pas être nulle. |
- Extensions
- cast.framework.messages.RequestData
Propriétés
currentItemId
(nombre ou non défini)
ID de l'élément multimédia actuel après l'insertion (si aucune valeur n'est fournie, la valeur "currentItem" sera la même qu'avant l'insertion).
currentItemIndex
(nombre ou non défini)
Index (par rapport au tableau d'éléments, en commençant par 0) du nouvel élément multimédia actuel. Pour les éléments insérés, nous utilisons l'index (semblable à startIndex dans QUEUE_LOAD) et non l'élément currentItemId, car l'itemId est inconnu jusqu'à ce que les éléments soient insérés. Si elle n'est pas fournie, la valeur "currentItem" sera la même qu'avant l'insertion (sauf si la valeur "currentItemId" est spécifiée). Ce paramètre permet d'utiliser Atom comme cas d'utilisation courant : insérer et lire un élément.
currentTime
(nombre ou non défini)
Nombre de secondes écoulées depuis le début du contenu avant le lancement de la lecture de l'élément en cours. Si cette valeur est fournie, elle prévaut sur la valeur startTime fournie au niveau de QueueItem, mais uniquement la première fois que l'élément est lu. Cela permet de couvrir le cas courant où l'utilisateur passe au milieu d'un élément afin que la valeur currentTime ne s'applique pas de manière permanente à l'élément, contrairement à la valeur startTime de QueueItem. Cela évite de devoir réinitialiser le startTime de manière dynamique (ce qui peut être impossible si le téléphone est en veille).
customData
(objet non nul ou non défini)
Données spécifiques à l'application pour cette requête. Elle permet à l'expéditeur et au destinataire d'étendre facilement le protocole multimédia sans avoir à utiliser un nouvel espace de noms avec des messages personnalisés.
insertBefore
(nombre ou non défini)
Identifiant de l'article qui se trouvera immédiatement après la liste insérée. Si l'ID est introuvable ou qu'il n'est pas fourni, la liste est ajoutée à la fin de la liste existante.
items
Tableau non nul de cast.framework.messages.QueueItem non nul
Liste des éléments de la file d'attente. Le champ "itemId" des articles doit être vide. Il est trié (le premier élément est lu en premier).
mediaSessionId
(nombre ou non défini)
ID de la session multimédia à laquelle la requête s'applique.
requestId
number
Identifiant de la requête, utilisé pour corréler la requête/la réponse.
sequenceNumber
(nombre ou non défini)
Nombre permettant de synchroniser toutes les commandes de file d'attente. S'il est fourni pour une commande de file d'attente, le SDK vérifie que le dernier numéro de séquence de la file d'attente correspond à la requête. Le paramètre "SequenceNumber" actuel est fourni dans les messages sortants de modification de la file d'attente.