Cette page explique comment créer une ressource de canal avec deux flux d'entrée, l'un pouvant servir de sauvegarde à l'autre.
Lorsque le basculement automatique est activé, si le flux d'entrée principal est déconnecté en raison de problèmes de réseau, le canal bascule automatiquement pour utiliser le flux d'entrée de secours comme source d'entrée. Une fois le flux d'entrée principal de nouveau en ligne, le canal revient automatiquement au flux d'entrée principal en tant que source d'entrée. La fonctionnalité de basculement automatique est facultative.
Vous devez vous assurer que le flux d'entrée principal et le flux d'entrée de secours sont identiques si vous souhaitez que le flux d'entrée de secours remplace complètement le flux d'entrée principal.
Vous pouvez également changer manuellement le flux d'entrée à l'aide d'un événement de canal.
Configurer votre authentification et votre projet Google Cloud
Si vous n'avez pas encore créé de projet Google Cloud ni d'identifiants, consultez la section Avant de commencer.Créer le point de terminaison d'entrée principal
Pour créer le point de terminaison d'entrée principal, utilisez la méthode projects.locations.inputs.create
.
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_NUMBER
: numéro de votre projet Google Cloud, qui se trouve dans le champ Numéro de projet sur la page Paramètres IAM.LOCATION
: emplacement dans lequel créer le point de terminaison d'entrée. Utilisez l'une des régions disponibles.Afficher les emplacementsus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-south1
asia-northeast1
asia-southeast1
australia-southeast1
europe-north1
europe-west1
europe-west2
europe-west3
europe-west4
INPUT_ID
: identifiant défini par l'utilisateur pour le nouveau point de terminaison d'entrée à créer (auquel vous envoyez votre flux d'entrée). Cette valeur doit comporter entre 1 et 63 caractères, commencer et se terminer par[a-z0-9]
, et peut contenir des tirets (-) entre les caractères. Par exemple,my-input
.
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API C# pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Go pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Java pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Node.js pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API PHP pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Python pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Ruby pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Créer le point de terminaison d'entrée de la sauvegarde
Pour créer le point de terminaison d'entrée de sauvegarde, utilisez à nouveau la méthode projects.locations.inputs.create
. Veillez à utiliser un ID d'entrée différent de celui du point de terminaison d'entrée principal.
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_NUMBER
: numéro de votre projet Google Cloud, qui se trouve dans le champ Numéro de projet sur la page Paramètres IAM.LOCATION
: emplacement dans lequel créer le point de terminaison d'entrée. Utilisez l'une des régions disponibles.Afficher les emplacementsus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-south1
asia-northeast1
asia-southeast1
australia-southeast1
europe-north1
europe-west1
europe-west2
europe-west3
europe-west4
BACKUP_INPUT_ID
: identifiant défini par l'utilisateur pour le point de terminaison d'entrée de sauvegarde à créer (et à utiliser si le flux d'entrée principal est déconnecté en raison de problèmes réseau). Cette valeur doit comporter entre 1 et 63 caractères, commencer et se terminer par[a-z0-9]
, et peut contenir des tirets (-) entre les caractères.
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/BACKUP_INPUT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API C# pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Go pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Java pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Node.js pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API PHP pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Python pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Ruby pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Créer la chaîne
Pour créer le canal, utilisez la méthode projects.locations.channels.create
. Dans cet exemple, automaticFailover
est configuré pour la première pièce jointe d'entrée.
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_NUMBER
: numéro de votre projet Google Cloud, qui se trouve dans le champ Numéro de projet sur la page Paramètres IAM.LOCATION
: emplacement dans lequel créer la chaîne. Utilisez l'une des régions disponibles.Afficher les emplacementsus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-south1
asia-northeast1
asia-southeast1
australia-southeast1
europe-north1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: identifiant défini par l'utilisateur pour le canal à créer. Cette valeur doit comporter entre 1 et 63 caractères, commencer et se terminer par[a-z0-9]
, et peut contenir des tirets (-) entre les caractères.INPUT_ID
: identifiant défini par l'utilisateur pour le point de terminaison d'entrée principalBACKUP_INPUT_ID
: identifiant défini par l'utilisateur pour le point de terminaison d'entrée de la sauvegardeBUCKET_NAME
: nom du bucket Cloud Storage que vous avez créé
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API C# pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Go pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Java pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Node.js pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API PHP pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Python pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente de l'API Live Stream, consultez la page Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Ruby pour la diffusion en direct.
Pour vous authentifier auprès de l'API Live Stream, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Changer manuellement la saisie
Pour passer manuellement de l'entrée principale à l'entrée de secours (par exemple, de my-primary-input
à my-backup-input
), créez un événement de canal.
Après un transfert manuel, vous pouvez déconnecter et reconnecter my-primary-input
à votre guise. Le canal ne passe pas à cette entrée lors de la reconnexion, comme il le ferait avec les paramètres de basculement automatique par défaut.
Pour revenir à my-primary-input
, effectuez l'une des opérations suivantes:
- Créez un événement
inputSwitch
oùinputKey
est défini surmy-primary-input
. Cet événement rétablit l'entrée principale sans restaurer les paramètres de basculement automatique. - Mettez à jour la chaîne pour activer le basculement automatique. Pour en savoir plus, consultez la section Événement de saisie du contacteur.