Les subscriptions sont un type de requête qui vous permet d'être notifié lorsque des modifications sont apportées à un appareil, un média ou une liste de lecture.
Par exemple, vous pourriez vouloir être notifié de toute modification apportée à votre appareil, qu'il s'agisse d'un changement de média ou de liste de lecture. Cela peut être entièrement réalisé dans GraphQL en utilisant des requêtes pour trouver les informations sur un appareil, en configurant une subscription, puis en utilisant des mutations pour modifier les attributs de l'appareil.
1. Configurer la Subscription
subscription subscribe($_id:String,$type:OBJECT_TYPES){
subscribe(_id:$_id,type:$type){
_id,
mutation,
teamId
type
}
}
Variables
{"_id":"",
"type": ""
}
Notez les éléments présents dans la requête de Subscription. Ce sont les éléments qu'elle surveillera et vous retournera lorsque l'un d'entre eux sera modifié via une Mutation.
Lorsqu'une Subscription est correctement saisie, vous devriez voir ceci sur le côté droit de l'interface GraphQL :
Cela signifie que tant que la Subscription est active, elle signalera toute modification apportée à l'élément.
2. Tester la Subscription
Ici, nous avons un script de Mutation qui modifie le nom et la liste de lecture sur l'appareil sélectionné.
mutation updateDevice($_id: String!,$payload: UpdateDeviceInput!, $teamId: String){
updateDevice(_id:$_id,payload:$payload,teamId:$teamId){
_id,
deviceName,
UUID,
pairingCode,
currentType,
currentAssetId,
currentPlaylistId,
path,
localAppVersion
}
}
Variables
{"_id": "",
"payload": {"deviceName": "",
"currentType": "",
"currentAssetId": "",
"currentPlaylistId": "",
"orientation": "LANDSCAPE"
}
}
Lorsque nous exécutons cette Mutation, nous pouvons basculer vers l'endroit où notre Subscription est en écoute et voir ceci :
Article précédent - Gestion des erreurs
Article suivant - Référence API