Abonnementsfunctie in GraphQL

Abonnementen zijn een querytype waarmee u op de hoogte kunt worden gesteld wanneer er wijzigingen worden aangebracht aan een apparaat, asset of afspeellijst.

Een voorbeeld kan zijn dat u op de hoogte wilt worden gesteld van wijzigingen die aan uw apparaat worden aangebracht, of dat nu het wijzigen van de asset of afspeellijst betreft. Dit kan volledig binnen GraphQL worden gedaan door queries te gebruiken om informatie over een apparaat te vinden, een abonnement in te stellen en vervolgens mutaties te gebruiken om de apparaatattributen te wijzigen.

1. Het Abonnement Instellen

subscription subscribe($_id:String,$type:OBJECT_TYPES){

  subscribe(_id:$_id,type:$type){

    _id,

    mutation,

    teamId

    type

  }

}

Variabelen

{"_id":"",

  "type": ""

}

Let op de elementen die aanwezig zijn in de Abonnement-query. Dit zijn de elementen die het zal monitoren en aan u zal terugmelden wanneer een ervan wordt gewijzigd via Mutatie.

Wanneer een Abonnement correct is ingevoerd, zou u dit aan de rechterkant van de GraphQL UI moeten zien:

Dit betekent dat zolang het Abonnement actief is, het alle wijzigingen aan het item zal rapporteren.

2. Het Abonnement Testen

Hier hebben we een Mutatie-script dat de naam en afspeellijst op het geselecteerde apparaat wijzigt.

mutation updateDevice($_id: String!,$payload: UpdateDeviceInput!, $teamId: String){
  updateDevice(_id:$_id,payload:$payload,teamId:$teamId){
     _id,
     deviceName,
     UUID,
     pairingCode,
     currentType,
     currentAssetId,
     currentPlaylistId,
     path,
     localAppVersion
  }
}

Variabelen

{"_id": "",
  "payload": {"deviceName": "",
    "currentType": "",
    "currentAssetId": "",
    "currentPlaylistId": "",
    "orientation": "LANDSCAPE"
  } 
} 

Wanneer we deze Mutatie uitvoeren, kunnen we overschakelen naar waar ons Abonnement luistert en dit zien:

Vorig Artikel - Foutafhandeling

Volgend Artikel - API-referentie