Cette page explique comment créer une ressource de canal avec deux flux d'entrée, un flux d'entrée pouvant servir de secours pour l'autre flux d'entrée.
Lorsque le basculement automatique est activé, si le flux d'entrée principal est déconnecté en raison de problèmes réseau, le canal bascule automatiquement pour utiliser le flux d'entrée de sauvegarde comme source d'entrée. Une fois que le flux d'entrée principal est 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 sauvegarde sont identiques si vous souhaitez que le flux d'entrée de sauvegarde 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 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, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud, qui se trouve dans le champ Numéro du projet de la page Paramètres IAMLOCATION
: emplacement de création du point de terminaison d'entrée (utilisez l'une des régions disponibles)Afficher les lieuxus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
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 (vers lequel vous envoyez votre flux d'entrée). Cette valeur doit comporter de 1 à 63 caractères. Elle doit commencer et se terminer par[a-z0-9]
. Elle peut contenir des tirets (-) entre les caractères. 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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream C#.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Go.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Java.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Node.js.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream PHP.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Python.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Ruby.
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 sauvegarde
Pour créer le point de terminaison d'entrée de sauvegarde, utilisez de nouveau la méthode projects.locations.inputs.create
. Veillez à utiliser un ID d'entrée différent de celui du point de terminaison principal de l'entrée.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud, qui se trouve dans le champ Numéro du projet de la page Paramètres IAMLOCATION
: emplacement de création du point de terminaison d'entrée (utilisez l'une des régions disponibles)Afficher les lieuxus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
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 (à utiliser si le flux d'entrée principal est déconnecté en raison de problèmes de réseau). Cette valeur doit être comprise 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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream C#.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Go.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Java.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Node.js.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream PHP.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Python.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Ruby.
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 le premier rattachement d'entrée.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud, qui se trouve dans le champ Numéro du projet de la page Paramètres IAMLOCATION
: emplacement de création du canal (utilisez l'une des régions disponibles)Afficher les lieuxus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
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. Elle doit 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 de l'entrée principaleBACKUP_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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream C#.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Go.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Java.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Node.js.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream PHP.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Python.
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 pour l'API Live Stream, consultez Bibliothèques clientes de l'API Live Stream. Pour en savoir plus, consultez la documentation de référence de l'API Live Stream Ruby.
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 d'entrée
Pour passer manuellement de l'entrée principale à l'entrée de sauvegarde (par exemple, my-primary-input
à my-backup-input
), créez un événement de canal.
Après un changement manuel, vous pouvez déconnecter et reconnecter my-primary-input
comme vous le souhaitez. Le canal ne bascule pas sur 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
dans lequelinputKey
est défini surmy-primary-input
. Cet événement revient à l'entrée principale sans restaurer les paramètres de basculement automatique. - Mettez à jour le canal pour activer le basculement automatique. Pour en savoir plus, consultez la section Événement de changement d'entrée.