addLiveDestination

Attache une destination de diffusion à un direct. Fournir soit destinationId, soit le triplet name + streamUrl + streamKey. Si les credentials correspondent à une destination déjà connue du compte, celle-ci est réutilisée et le nom fourni est ignoré.

Arguments

Nom	Type	Description
`liveId*`	`ID!`	Identifiant du direct.
`destinationId`	`ID`	Identifiant d'une destination existante du compte.
`name`	`String`	Nom de la destination, utilisé à la création uniquement.
`streamUrl`	`String`	URL de diffusion RTMP ou RTMPS.
`streamKey`	`String`	Clé de diffusion.
`active*`	`Boolean!= true`	Active immédiatement la diffusion vers cette destination.

Utilisation

Chargement...

Réponse

Live

Nom	Type	Description
`id`	`ID!`	Identifiant unique du direct.
`title`	`String!`	Titre du direct.
`status`	`LiveStatusType!`	Statut courant du direct. Valeurs possibles : Unplugged : Wowza (legacy), transcoder non branché. Plugging : Wowza (legacy), branchement du transcoder en cours. Scheduled : programmé, prêt à démarrer (startPreview possible). Starting : démarrage en cours (instance Roquette / transcoder Wowza). Idle : preview prête côté infra, en attente d'un flux exploitable. Preview : prévisualisation active (flux reçu, non diffusé au public). Running : en diffusion publique. Stopping : arrêt du direct en cours. Ended : direct terminé. Archived : direct archivé (supprimé logiquement). Error : erreur de démarrage ou interruption anormale.
`myCapability`	`AuthzCapability!`	Ce que l'appelant a le droit de faire sur ce contenu, compte tenu de ses groupes et de ses accès directs : `NONE` (aucun accès), `READ`, `WRITE` ou `DELETE`. Permet de savoir à l'avance si une mutation aboutira, sans avoir à la tenter.
`note`	`String`	Note interne sur le direct.
`duration`	`Int`	Durée du direct en secondes.
`currentAudience` Déprécié	`Int`	Audience temps réel : nombre de spectateurs uniques sur la dernière minute glissante. Calculé à la volée, null hors direct (status != Running). Déprécié : Utiliser getLiveAnalytics(id: ...).realtime.currentViewers
`maxPeakViewers` Déprécié	`Int`	Pic de spectateurs uniques atteint pendant le direct, figé à la fin du direct. À afficher une fois le direct terminé. Déprécié : Utiliser getLiveAnalytics(id: ...).realtime.peakConcurrentViewers
`fallbackAcknowledged`	`Boolean`	Indique si le fallback a été acquitté par l'utilisateur.
`publicUrl`	`String`	URL de la page de lecture publique.
`publicEmbedUrl`	`String`	URL d'intégration (embed) publique.
`shouldShowCountdown`	`Boolean`	Affiche un compte à rebours avant le direct.
`isRocket`	`Boolean!`	Indique si le direct est diffusé via Roquette (sinon Wowza legacy).
`activeSource`	`RelaySource`	Source d'ingest actuellement diffusée — Roquette uniquement.
`fallbackActive`	`Boolean`	Indique si le fallback est actuellement actif.
`waitingThumbKey`	`String`	Clé S3 de la vignette d'attente.
`waitingThumbCdnUrl`	`String`	URL CDN de la vignette d'attente.
`thumbnailVttCdnUrl`	`String`	URL CDN du VTT des vignettes de scrubbing (live Rocket uniquement, sinon null).
`deltaChapter`	`Int`	Décalage en secondes appliqué aux points de chapitre à la lecture, pour rattraper la latence d'encodage et de diffusion.
`accessGroups`	`[Group!]!`	Groupes ayant accès à ce direct.
`directUsers`	`[PublicUser!]!`	Utilisateurs ayant un accès direct à ce direct.
`publisher`	`User`	Utilisateur ayant créé le direct.
`account`	`Account`	Compte propriétaire du direct.
`createdAt`	`DateTime`	Date de création du direct.
`updatedAt`	`DateTime`	Date de dernière modification du direct.
`scheduledStartAt`	`DateTime`	Date de début programmée (saisie par l'utilisateur, informative).
`lifecycle`	`LiveLifecycle`	Dates réelles du cycle de vie (démarrages, fin, échéances d'arrêt auto).
`ingest`	`LiveIngest`	Credentials d'ingest (RTMP / SRT).
`playback`	`LivePlayback`	URLs de lecture du direct (HLS).
`recording`	`LiveRecording`	Options d'enregistrement et de relecture (DVR, VOD, replay).
`relaySources`	`[RelaySourceInfo!]`	État de chaque source d'ingest (primary / backup) — Roquette uniquement.
`transcoder` Déprécié	`TranscoderTMP`	Transcoder Wowza associé (legacy). Déprécié : Transcoder Wowza legacy, sera retiré.
`transcoderInfos`	`TranscoderInfos`	Infos temps réel du transcoder (bitrate, résolution, cibles).
`subtitles`	`LiveSubtitles`	Configuration du sous-titrage en direct — Roquette uniquement.
`chapters`	`[Chapter]`	Chapitres associés au direct.
`files`	`[File!]`	Fichiers joints au direct.
`discussion`	`Discussion`	Discussion (chat) associée au direct.
`liveDestinations`	`[LiveDestination]`	Destinations de simulcast (réémission RTMP vers des plateformes tierces).
`relatedTags`	`[Tag]`	Tags rattachés.
`relatedCategories`	`[Category]`	Catégories rattachées.
`pageSetting`	`BrandSetting`	Paramètres de personnalisation de la page de lecture.
`embedSetting`	`BrandSetting`	Paramètres de personnalisation de l'embed.
`seo`	`SEO`	Paramètres SEO de la page de lecture.
`confidentiality`	`Confidentiality`	Niveau de confidentialité (nouveau modèle).
`privacy`	`Privacy`	Paramètres de confidentialité (accès utilisateur).
`playlists`	`PlaylistConnection`	Playlists contenant ce direct.
`webTVs`	`WebTVConnection`	WebTVs contenant ce direct.
`originalPublisher`	`DeletedUser`	-

Erreurs

Erreurs communes

Code	Message	Description
`UNAUTHENTICATED`	`You are not authorized to perform this action`	Clé API manquante, invalide, expirée ou révoquée. La réponse porte un code HTTP 200 : c'est le corps GraphQL qui signale l'échec.
`INPUT_VALIDATION_ERROR`	`Validation failed: {field}: {message}`	Un ou plusieurs champs sont invalides (format, longueur, protocole…). Le détail est dans extensions.fieldErrors[].
`INTERNAL_SERVER_ERROR`	`Internal server error`	Erreur interne du serveur. Le message est volontairement générique : le détail est journalisé côté Streamfizz, jamais renvoyé.

Erreurs spécifiques

Code	Message	Description
`DESTINATION_NAME_TAKEN`	`Another destination of this account already uses this name`	Une nouvelle destination est créée (aucun `destinationId` fourni, ou les credentials `streamUrl`/`streamKey` ne correspondent à aucune destination existante) mais le `name` fourni est déjà pris par une autre destination du compte. Fournir `destinationId` pour réutiliser une destination existante, ou choisir un autre nom.
`DESTINATION_ALREADY_ATTACHED`	`This destination is already attached to this live`	La destination est déjà attachée à ce direct.
`DESTINATION_INVALID_URL`	`The stream URL is invalid or unreachable`	L'URL de diffusion (`streamUrl`) fournie est invalide ou injoignable côté Wowza (nom d'hôte non résolu). Ne concerne que les directs encore sur l'infrastructure Wowza.
`DESTINATION_CONFIG_FAILED`	`Failed to configure the destination on the streaming engine`	Échec de la configuration de la destination côté Wowza, pour une raison autre qu'une URL invalide. Ne concerne que les directs encore sur l'infrastructure Wowza.
`NOT_FOUND`	`Destination '{id}' not found`	Le `destinationId` fourni n'existe pas, ou appartient à un autre compte. C'est le cas le plus fréquent de ce code sur cette mutation.

Rate Limiting

60 requêtes par minute par clé API

En cas de dépassement, une erreur 429 Too Many Requests est retournée.

Page précédentestopLive

MUTATION

Page suivanteremoveLiveDestination