Istruzioni per la CLI - Amazon Interactive Video Service
Creazione di un canale senza la registrazioneCreazione di un canale con la registrazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Istruzioni per la CLI

La creazione di un canale con la AWS CLI è un'opzione avanzata e richiede prima di scaricare e configurare la CLI sul computer. Per maggiori dettagli, consultare la Guida per l'utente dell'interfaccia a riga di comando di AWS.

Seguire una delle due procedure riportate a seconda che si desideri creare un canale con o senza registrazione abilitata.

Creazione di un canale senza la registrazione

  1. Eseguire il comando create-channel e inviare un nome facoltativo:

    aws ivs create-channel --name test-channel

  2. Viene restituito un nuovo canale:

    {
   "channel": {
      "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
      "authorized": false,
      "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
      "insecureIngest": false,
      "latencyMode": "LOW",
      "name": "channel-live",
      "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/abcdABCDefgh",
      "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
      "recordingConfigurationArn": "none",
      "tags": {},
      "type": "STANDARD"
   },
   "streamKey": {
      "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
      "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
      "tags": {},
      "value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
   }
}

  3. Importante: prendere nota di ingestEndpoint, streamKey value e playbackUrl. Si useranno questi valori per configurare lo streaming e la riproduzione.

Creazione di un canale con la registrazione

Prerequisito: prima di iniziare questa procedura, è necessario creare un bucket Amazon S3 e prendere nota del relativo ARN. Consultare Nozioni di base su Amazon S3. Il bucket S3 deve trovarsi nella stessa regione in cui verrà creata una configurazione di registrazione; fare riferimento al problema noto riportato nella Fase 1 di seguito.

Quindi, completare la procedura indicata per creare il canale:

  1. Eseguire il comando create-recording-configuration e inviare l'ARN di un bucket Amazon S3 esistente:

    aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket}

    Facoltativamente, passare il parametro thumbnail-configuration per impostare manualmente la modalità di registrazione delle anteprime e l'intervallo delle anteprime:

    aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=s3_bucket_name} --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=60

    Facoltativamente, passare il parametro recording-reconnect-window-seconds per abilitare la funzionalità di unione di flussi frammentati:

    aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} --recording-reconnect-window-seconds 60

    Problema noto: nella Regione us-east-1, se si utilizza AWS CLI per creare una configurazione di registrazione, l'operazione riesce anche se il bucket S3 si trova in una Regione diversa. In questo caso, la state della configurazione di registrazione è CREATE_FAILED (anziché ACTIVE). In altre aree, se il bucket si trova in una regione diversa la CLI restituisce un errore.

    Soluzione alternativa: verificare che il bucket S3 si trovi nella stessa regione della configurazione di registrazione. Se si crea una configurazione di registrazione in una regione diversa da quella del bucket S3, eliminarla e creane una nuova con un bucket S3 dalla regione corretta.

  2. In questo modo si avrà una nuova configurazione di registrazione con un ARN univoco. Lo stato della configurazione di registrazione è CREATING, a indicare che è in fase di creazione.

    {
   "recordingConfiguration": {
      "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
      "name": "configuration-1",
      "destinationConfiguration": {
         "s3": {
            "bucketName": "s3_bucket_name"
         }
      },
      "recordingReconnectWindowSeconds": 60,
      "state": "CREATING",
      "tags": {},
      "thumbnailConfiguration": {
         "recordingMode": "INTERVAL",
         "targetIntervalSeconds": 60
      }
   }
}

  3. In genere, la creazione della configurazione di registrazione richiede poco, ma può durare fino a 20 secondi. Per verificare che la configurazione di registrazione sia stata creata, emettere il comando get-recording-configuration:

    aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"

  4. Sarà restituita una risposta che indica che la configurazione di registrazione è stata creata (state è ACTIVE):

    {
   "recordingConfiguration": {
      "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
      "name": "configuration-1",
      "destinationConfiguration": {
         "s3": {
            "bucketName": "s3_bucket_name"
         }
      },
      "recordingReconnectWindowSeconds": 60,
      "state": "ACTIVE",
      "tags": {},
      "thumbnailConfiguration": {
         "recordingMode": "INTERVAL",
         "targetIntervalSeconds": 60
      }
   }
}

  5. Per creare un canale e abilitare la registrazione su di esso, eseguire il comando create-channel e inviare l'ARN della configurazione di registrazione:

    aws ivs create-channel --name channel-live --recording-configuration-arn  "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"

    In alternativa, per abilitare la registrazione su un canale esistente, eseguire il comando update-channel e inviare l'ARN della configurazione di registrazione:

    aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"

  6. Questa operazione restituisce un oggetto canale con un valore diverso da "none" per recordingConfigurationArn, che indica che la registrazione è abilitata. La risposta seguente proviene da create-channel. La risposta update-channel non include l'oggetto streamKey.

    {
   "channel": {
      "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
      "authorized": false,
      "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
      "insecureIngest": false,
      "latencyMode": "LOW",
      "name": "channel-live",
      "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
      "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
      "tags": {},
      "type": "STANDARD"
   },
   "streamKey": {
      "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
      "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
      "tags": {},
      "value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
   }
}

  7. Importante: prendere nota di ingestEndpoint, streamKey value e playbackUrl. Si useranno questi valori per configurare lo streaming e la riproduzione.