CLI-Anweisungen - Amazon Interactive Video Service
Erstellen eines Kanals ohne AufzeichnungErstellen eines Kanals mit Aufzeichnung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CLI-Anweisungen

Das Erstellen eines Kanals mit der AWS CLI ist eine Advanced Option und erfordert, dass Sie zuerst die CLI auf Ihrem Computer herunterladen und konfigurieren. Informationen zu den ersten Schritten finden Sie im Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle.

Führen Sie eines der beiden folgenden Verfahren aus, je nachdem, ob Sie einen Kanal mit oder ohne aktivierte Aufzeichnung erstellen möchten.

Erstellen eines Kanals ohne Aufzeichnung

  1. Ausführen des create-channel-Befehls und Übergabe eines optionalen Namen:

    aws ivs create-channel --name test-channel

  2. Dies gibt einen neuen Kanal zurück:

    {
   "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. Wichtig: Beachten Sie ingestEndpoint, streamKey value und playbackUrl. Sie werden diese verwenden, um Streaming und Wiedergabe einzurichten.

Erstellen eines Kanals mit Aufzeichnung

Voraussetzungen: Erstellen Sie vor Beginn dieses Verfahrens einen Amazon-S3-Bucket und notieren Sie sich dessen ARN. Siehe Erste Schritte mit Amazon S3. Der S3-Bucket muss sich in derselben Region befinden, in der Sie eine Aufzeichnungskonfiguration erstellen. Siehe das bekannte Problem in Schritt 1 unten.

Gehen Sie dann wie folgt vor, um den Kanal zu erstellen:

  1. Führen Sie den Befehl create-recording-configuration aus und geben Sie den ARN von einem vorhandenen Amazon S3 Bucket ein:

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

    Übergeben Sie optional den Parameter thumbnail-configuration, um den Miniaturaufzeichnungsmodus und das Miniaturansichtsintervall manuell einzustellen:

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

    Übergeben Sie optional die recording-reconnect-window-seconds-Parameter zum Aktivieren der Funktion zum Zusammenführen fragmentierter Streams:

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

    Bekanntes Problem: Wenn Sie in der Region us-east-1 zum Erstellen einer Aufnahmekonfiguration die AWS CLI verwenden, wird die Meldung „erfolgreich“ zurückgegeben, auch wenn sich der S3-Bucket in einer anderen Region befindet. In diesem Fall ist die state der Aufzeichnungskonfiguration CREATE_FAILED (anstelle von ACTIVE) enthalten. (In anderen Regionen gibt die CLI korrekt einen Fehler zurück, wenn sich der Bucket in einer anderen Region befindet.)

    Problemumgehung: Stellen Sie sicher, dass sich Ihr S3-Bucket in derselben Region wie die Aufnahmekonfiguration befindet. Wenn Sie eine Aufzeichnungskonfiguration in einer anderen Region als Ihrem S3-Bucket erstellen, löschen Sie diese Aufzeichnungskonfiguration und erstellen Sie eine neue mit einem S3-Bucket aus der richtigen Region.

  2. Dies gibt eine neue Aufzeichnungskonfiguration mit einem eindeutigen ARN zurück. Der Status der Aufzeichnungskonfiguration ist CREATING. Dies zeigt an, dass es gerade erstellt wird.

    {
   "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 der Regel dauert die Erstellung der Aufnahmekonfiguration einige Sekunden, aber es kann bis zu 20 Sekunden dauern. Um zu überprüfen, ob die Aufzeichnungskonfiguration erstellt wurde, führen Sie den get-recording-configuration-Befehl aus:

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

  4. Dies gibt eine Antwort zurück, die angibt, dass die Aufzeichnungskonfiguration erstellt wurde (state ist 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. Um einen Kanal zu erstellen und die Aufzeichnung zu aktivieren, führen Sie den create-channel-Befehl aus und übergeben Sie den ARN für die Aufzeichnungskonfiguration:

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

    Um die Aufzeichnung auf einem vorhandenen Kanal zu aktivieren, führen Sie alternativ den update-channel-Befehl aus und übergeben Sie den ARN für die Aufzeichnungskonfiguration:

    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. Hiermit wird ein Kanalobjekt mit einem Wert für recordingConfigurationArn zurückgegeben, der nicht „none“ ist. Das zeigt an, dass die Aufzeichnung aktiviert ist. (Die folgende Antwort stammt aus create-channel. Die update-channel-Antwort enthält nicht das streamKey-Objekt.)

    {
   "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. Wichtig: Beachten Sie ingestEndpoint, streamKey value und playbackUrl. Sie werden diese verwenden, um Streaming und Wiedergabe einzurichten.