Ejemplos de streaming en tiempo real de Amazon IVS utilizando AWS CLI - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de ejemplos de AWS Doc SDK.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de streaming en tiempo real de Amazon IVS utilizando AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante Amazon IVS Real-Time Streaming. AWS Command Line Interface

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar create-encoder-configuration.

AWS CLI

Para crear una configuración de codificador de composición

En el siguiente ejemplo de create-encoder-configuration, se crea una configuración de codificador de composición con las propiedades especificadas.

aws ivs-realtime create-encoder-configuration \
    --name test-ec --video bitrate=3500000,framerate=30.0,height=1080,width=1920

Salida:

{
    "encoderConfiguration": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef",
        "name": "test-ec",
        "tags": {},
        "video": {
            "bitrate": 3500000,
            "framerate": 30,
            "height": 1080,
            "width": 1920
        }
    }
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar create-ingest-configuration.

AWS CLI

Creación de una configuración de ingesta

En el siguiente ejemplo de create-ingest-configuration, se crea una configuración de ingesta mediante el protocolo RTMPS.

aws ivs-realtime create-ingest-configuration \
    --name ingest1 \
    --ingest-protocol rtmps

Salida:

{
    "ingestConfiguration": {
        "name": "ingest1",
        "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
        "ingestProtocol": "RTMPS",
        "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
        "stageArn": "",
        "participantId": "xyZ654abC321",
        "state": "INACTIVE",
        "userId": "",
        "tags": {}
    }
}

Para obtener más información, consulte Ingesta de transmisiones de IVS | Transmisión en tiempo real en la Guía del usuario de Servicio de vídeos interactivos de Amazon.

En el siguiente ejemplo de código, se muestra cómo utilizar create-participant-token.

AWS CLI

Para crear un token de participante de la fase

En el siguiente ejemplo de create-participant-token, se crea un token de participante para la etapa especificada.

aws ivs-realtime create-participant-token \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --user-id bob

Salida:

{
    "participantToken": {
        "expirationTime": "2023-03-07T09:47:43+00:00",
        "participantId": "ABCDEfghij01234KLMN6789",
        "token": "abcd1234defg5678"
    }
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulte CreateParticipantTokenla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-stage.

AWS CLI

Ejemplo 1: crear un escenario

En el siguiente ejemplo de create-stage, se crea un token de fase y un token de participante de la fase para un usuario especificado.

aws ivs-realtime create-stage \
    --name stage1 \
    --participant-token-configurations userId=alice

Salida:

{
    "participantTokens": [
        {
            "participantId": "ABCDEfghij01234KLMN5678",
            "token": "a1b2c3d4567890ab",
            "userId": "alice"
        }
    ],
    "stage": {
        "activeSessionId": "st-a1b2c3d4e5f6g",
        "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
        "autoParticipantRecordingConfiguration": {
            "storageConfigurationArn": "",
            "mediaTypes": [
                "AUDIO_VIDEO"
            ],
            "thumbnailConfiguration": {
                "targetIntervalSeconds": 60,
                "storage": [
                    "SEQUENTIAL"
                ],
                "recordingMode": "DISABLED"
            },
            "recordingReconnectWindowSeconds": 0,
            "hlsConfiguration": {
                "targetSegmentDurationSeconds": 6
            },
            "recordParticipantReplicas": true
        },
        "endpoints": {
            "events": "wss://global.events.live-video.net",
            "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
            "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
            "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
        },
        "name": "stage1",
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 2: crear una fase y configurar una grabación de participante individual

En el siguiente ejemplo de create-stage, se crea una fase y se configura la grabación de cada participante individual.

aws ivs-realtime create-stage \
    --name stage1 \
    --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
        "hlsConfiguration": {"targetSegmentDurationSeconds": 5}}'

Salida:

{
    "stage": {
        "activeSessionId": "st-a1b2c3d4e5f6g",
        "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
        "autoParticipantRecordingConfiguration": {
            "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh"
            "mediaTypes": [
                "AUDIO_VIDEO"
            ],
            "thumbnailConfiguration": {
                "targetIntervalSeconds": 60,
                "storage": [
                    "SEQUENTIAL"
                ],
                "recordingMode": "DISABLED"
            },
            "recordingReconnectWindowSeconds": 100,
            "hlsConfiguration": {
                "targetSegmentDurationSeconds": 5
            },
            "recordParticipantReplicas": true
        },
        "endpoints": {
            "events": "wss://global.events.live-video.net",
            "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
            "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
            "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
        },
        "name": "stage1",
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 3: creación de una etapa y configuración de una grabación de participante individual con grabación de miniaturas habilitada

En el siguiente ejemplo de create-stage, se crea una etapa y se configura la grabación de cada participante individual con grabación de miniaturas habilitada.

aws ivs-realtime create-stage \
    --name stage1 \
    --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", \
        "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}}'

Salida:

{
    "stage": {
        "activeSessionId": "st-a1b2c3d4e5f6g",
        "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
        "autoParticipantRecordingConfiguration": {
            "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
            "mediaTypes": [
                "AUDIO_VIDEO"
            ],
            "thumbnailConfiguration": {
                "targetIntervalSeconds": 60,
                "storage": [
                    "SEQUENTIAL"
                ],
                "recordingMode": "INTERVAL"
            },
            "recordingReconnectWindowSeconds": 0,
            "hlsConfiguration": {
                "targetSegmentDurationSeconds": 6
            },
            "recordParticipantReplicas": true
        },
        "endpoints": {
            "events": "wss://global.events.live-video.net",
            "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
            "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
            "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
        },
        "name": "stage1",
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

  • Para obtener más información sobre la API, consulte CreateStagela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-storage-configuration.

AWS CLI

Para crear una configuración de almacenamiento de composición

En el siguiente ejemplo de create-storage-configuration, se crea una configuración de almacenamiento de composición con las propiedades especificadas.

aws ivs-realtime create-storage-configuration \
    --name "test-sc" --s3 "bucketName=amzn-s3-demo-bucket"

Salida:

{
    "storageConfiguration": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef",
        "name": "test-sc",
        "s3": {
            "bucketName": "amzn-s3-demo-bucket"
        },
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-encoder-configuration.

AWS CLI

Para eliminar una configuración de codificador de composición

En el siguiente ejemplo de delete-encoder-configuration, se elimina la configuración del codificador de composición especificada por el ARN (Nombre de recurso de Amazon) indicado.

aws ivs-realtime delete-encoder-configuration \
    --arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"

Este comando no genera ninguna salida.

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-ingest-configuration.

AWS CLI

Ejemplo 1: eliminación de una configuración de ingesta inactiva

En el siguiente ejemplo de delete-ingest-configuration, se elimina la configuración de ingesta inactiva para un nombre de recurso de Amazon (ARN) de configuración de ingesta especificado.

aws ivs-realtime delete-ingest-configuration \
    --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234

Este comando no genera ninguna salida.

Para obtener más información, consulte Ingesta de transmisiones de IVS | Transmisión en tiempo real en la Guía del usuario de Servicio de vídeos interactivos de Amazon.

Ejemplo 2: forzar la eliminación de una configuración de ingesta activa

En el siguiente ejemplo de delete-ingest-configuration, se fuerza la eliminación de la configuración de ingesta activa para un nombre de recurso de Amazon (ARN) de configuración de ingesta especificado.

aws ivs-realtime delete-ingest-configuration \
    --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
    --force

Este comando no genera ninguna salida.

Para obtener más información, consulte Ingesta de transmisiones de IVS | Transmisión en tiempo real en la Guía del usuario de Servicio de vídeos interactivos de Amazon.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-public-key.

AWS CLI

Para eliminar una clave pública

En el siguiente ejemplo de delete-public-key, se elimina la clave pública especificada.

aws ivs-realtime delete-public-key \
    --arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2

Este comando no genera ninguna salida.

Para obtener más información, consulte Distribuir los tokens de participantes en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

  • Para obtener más información sobre la API, consulte DeletePublicKeyla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-stage.

AWS CLI

Para eliminar un escenario

En el siguiente ejemplo de delete-stage, se elimina la fase especificada.

aws ivs-realtime delete-stage \
    --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh

Este comando no genera ninguna salida.

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulte DeleteStagela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-storage-configuration.

AWS CLI

Para eliminar una configuración del almacenamiento de composición

En el siguiente ejemplo de delete-storage-configuration, se elimina la configuración del almacenamiento de composición especificada por el ARN (Nombre de recurso de Amazon) indicado.

aws ivs-realtime delete-storage-configuration \
    --arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef"

Este comando no genera ninguna salida.

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar disconnect-participant.

AWS CLI

Para desconectar a un participante de la fase

En el siguiente ejemplo de disconnect-participant, se desconecta al participante especificado de la fase indicada.

aws ivs-realtime disconnect-participant \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --participant-id ABCDEfghij01234KLMN5678

Este comando no genera ninguna salida.

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulte DisconnectParticipantla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-composition.

AWS CLI

Ejemplo 1: obtener una composición con los ajustes de diseño predeterminados

En el siguiente ejemplo de get-composition, se obtiene la composición del ARN (Nombre de recurso de Amazon) especificado.

aws ivs-realtime get-composition \
    --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"

Salida:

{
    "composition": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
        "destinations": [
            {
                "configuration": {
                    "channel": {
                        "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
                        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                    },
                    "name": ""
                },
                "id": "AabBCcdDEefF",
                "startTime": "2023-10-16T23:26:00+00:00",
                "state": "ACTIVE"
            },
            {
                "configuration": {
                    "name": "",
                    "s3": {
                        "encoderConfigurationArns": [
                            "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                        ],
                        "recordingConfiguration": {
                            "format": "HLS",
                            "hlsConfiguration": {
                                "targetSegmentDurationSeconds": 2
                            }
                        },
                        "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
                    }
                },
                "detail": {
                    "s3": {
                        "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
                    }
                },
                "id": "GHFabcgefABC",
                "startTime": "2023-10-16T23:26:00+00:00",
                "state": "STARTING"
            }
        ],
        "layout": {
            "grid": {
                "featuredParticipantAttribute": ""
                "gridGap": 2,
                "omitStoppedVideo": false,
                "videoAspectRatio": "VIDEO",
                "videoFillMode": ""
            }
        },
        "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
        "startTime": "2023-10-16T23:24:00+00:00",
        "state": "ACTIVE",
        "tags": {}
    }
}

Para obtener más información, consulte Grabación compuesta de IVS | Transmisión en tiempo real en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

Ejemplo 2: obtener una composición con los ajustes de diseño predeterminados

En el siguiente ejemplo de get-composition, se obtiene la composición del ARN (Nombre de recurso de Amazon) especificado que usa el diseño predeterminado.

aws ivs-realtime get-composition \
    --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs"

Salida:

{
    "composition": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs",
        "destinations": [
            {
                "configuration": {
                    "channel": {
                        "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
                        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                    },
                    "name": ""
                },
                "id": "AabBCcdDEefF",
                "startTime": "2023-10-16T23:26:00+00:00",
                "state": "ACTIVE"
            },
            {
                "configuration": {
                    "name": "",
                    "s3": {
                        "encoderConfigurationArns": [
                            "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                        ],
                        "recordingConfiguration": {
                            "format": "HLS",
                            "hlsConfiguration": {
                                "targetSegmentDurationSeconds": 2
                            }
                        },
                        "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
                    }
                },
                "detail": {
                    "s3": {
                        "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
                    }
                },
                "id": "GHFabcgefABC",
                "startTime": "2023-10-16T23:26:00+00:00",
                "state": "STARTING"
            }
        ],
        "layout": {
            "pip": {
                "featuredParticipantAttribute": "abcdefg",
                "gridGap": 0,
                "omitStoppedVideo": false,
                "pipBehavior": "STATIC",
                "pipOffset": 0,
                "pipParticipantAttribute": "",
                "pipPosition": "BOTTOM_RIGHT",
                "videoFillMode": "COVER"
            }
        },
        "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
        "startTime": "2023-10-16T23:24:00+00:00",
        "state": "ACTIVE",
        "tags": {}
    }
}

Para obtener más información, consulte Grabación compuesta de IVS | Transmisión en tiempo real en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

Ejemplo 3: obtención de una composición con la grabación de miniaturas habilitada

En el siguiente ejemplo de get-composition, se obtiene la composición para el ARN (Nombre de recurso de Amazon) especificado, que tiene la grabación de miniaturas habilitada con la configuración predeterminada.

aws ivs-realtime get-composition \
    --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"

Salida:

{
    "composition": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
        "destinations": [
            {
                "configuration": {
                    "channel": {
                        "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
                        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                    },
                    "name": ""
                },
                "id": "AabBCcdDEefF",
                "startTime": "2023-10-16T23:26:00+00:00",
                "state": "ACTIVE"
            },
            {
                "configuration": {
                    "name": "",
                    "s3": {
                        "encoderConfigurationArns": [
                            "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                        ],
                        "recordingConfiguration": {
                            "format": "HLS",
                            "hlsConfiguration": {
                                "targetSegmentDurationSeconds": 2
                            }
                        },
                        "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
                        "thumbnailConfigurations": [
                           {
                              "targetIntervalSeconds": 60,
                              "storage": [
                                  "SEQUENTIAL"
                              ],
                           }
                        ]
                    }
                },
                "detail": {
                    "s3": {
                        "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
                    }
                },
                "id": "GHFabcgefABC",
                "startTime": "2023-10-16T23:26:00+00:00",
                "state": "STARTING"
            }
        ],
        "layout": {
            "grid": {
                "featuredParticipantAttribute": ""
                "gridGap": 2,
                "omitStoppedVideo": false,
                "videoAspectRatio": "VIDEO",
                "videoFillMode": ""                }
        },
        "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
        "startTime": "2023-10-16T23:24:00+00:00",
        "state": "ACTIVE",
        "tags": {}
    }
}

Para obtener más información, consulte Grabación compuesta de IVS | Transmisión en tiempo real en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

  • Para obtener más información sobre la API, consulte GetCompositionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-encoder-configuration.

AWS CLI

Para eliminar una configuración de codificador de composición

En el siguiente ejemplo de get-encoder-configuration, se obtiene la configuración del codificador de composición especificada por el ARN (Nombre de recurso de Amazon) indicado.

aws ivs-realtime get-encoder-configuration \
    --arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh"

Salida:

{
    "encoderConfiguration": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh",
        "name": "test-ec",
        "tags": {},
        "video": {
            "bitrate": 3500000,
            "framerate": 30,
            "height": 1080,
            "width": 1920
        }
    }
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar get-ingest-configuration.

AWS CLI

Obtención de información de configuración de ingesta

En el siguiente ejemplo de get-ingest-configuration, se obtiene la configuración de ingesta para un nombre de recurso de Amazon (ARN) de configuración de ingesta especificado.

aws ivs-realtime get-ingest-configuration \
    --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234

Salida:

{
    "ingestConfiguration": {
        "name": "ingest1",
        "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
        "ingestProtocol": "RTMPS",
        "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
        "stageArn": "",
        "participantId": "xyZ654abC321",
        "state": "INACTIVE",
        "userId": "",
        "tags": {}
    }
}

Para obtener más información, consulte Ingesta de transmisiones de IVS | Transmisión en tiempo real en la Guía del usuario de Servicio de vídeos interactivos de Amazon.

  • Para obtener más información sobre la API, consulte GetIngestConfigurationla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-participant.

AWS CLI

Ejemplo 1: Para conseguir un participante en el escenario

En el siguiente ejemplo de get-participant, se obtiene al participante de la fase para un ID de participante y un ID de sesión específicos en el ARN (Nombre de recurso de Amazon) de la fase especificada.

aws ivs-realtime get-participant \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g \
    --participant-id abCDEf12GHIj

Salida:

{
    "participant": {
        "browserName": "Google Chrome",
        "browserVersion": "116",
        "firstJoinTime": "2023-04-26T20:30:34+00:00",
        "ispName": "Comcast",
        "osName": "Microsoft Windows 10 Pro",
        "osVersion": "10.0.19044",
        "participantId": "abCDEf12GHIj",
        "published": true,
        "recordingS3BucketName": "bucket-name",
        "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
        "recordingState": "ACTIVE",
        "sdkVersion": "",
        "state": "CONNECTED",
        "userId": ""
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 2: Para conseguir un participante en el escenario que haya sido replicado en otro escenario

En el siguiente get-participant ejemplo, se obtiene al participante de la etapa para un ID de participante específico y un ID de sesión en el ARN (Amazon Resource Name) de la etapa especificada, cuando el participante también se ha replicado en otra etapa.

aws ivs-realtime get-participant \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g \
    --participant-id abCDEf12GHIj

Salida:

{
    "participant": {
        "browserName": "Google Chrome",
        "browserVersion": "116",
        "firstJoinTime": "2023-04-26T20:30:34+00:00",
        "ispName": "Comcast",
        "osName": "Microsoft Windows 10 Pro",
        "osVersion": "10.0.19044",
        "participantId": "abCDEf12GHIj",
        "published": true,
        "recordingS3BucketName": "bucket-name",
        "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
        "recordingState": "ACTIVE",
        "replicationState": "ACTIVE",
        "replicationType": "SOURCE",
        "sdkVersion": "",
        "state": "CONNECTED",
        "userId": ""
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 3: Obtener un participante del escenario que haya sido replicado desde otro escenario

En el siguiente get-participant ejemplo, se obtiene al participante de la etapa para un ID de participante específico y un ID de sesión en el ARN (Amazon Resource Name) de la etapa especificada, cuando el participante se ha replicado desde otra etapa.

aws ivs-realtime get-participant \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g \
    --participant-id abCDEf12GHIj

Salida:

{
    "participant": {
        "browserName": "Google Chrome",
        "browserVersion": "116",
        "firstJoinTime": "2023-04-26T20:30:34+00:00",
        "ispName": "Comcast",
        "osName": "Microsoft Windows 10 Pro",
        "osVersion": "10.0.19044",
        "participantId": "abCDEf12GHIj",
        "published": true,
        "recordingS3BucketName": "bucket-name",
        "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
        "recordingState": "ACTIVE",
        "replicationState": "ACTIVE",
        "replicationType": "REPLICA",
        "sdkVersion": "",
        "state": "CONNECTED",
        "userId": ""
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

  • Para obtener más información sobre la API, consulte la Referencia GetParticipantde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-public-key.

AWS CLI

Para obtener una clave pública existente que se utilice para firmar los tokens de los participantes de la fase

En el siguiente ejemplo de get-public-key, se obtiene una clave pública especificada por el ARN proporcionado para firmar los tokens de los participantes de la fase.

aws ivs-realtime get-public-key \
    --arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2

Salida:

{
    "publicKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
        "name": "",
        "publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----",
        "fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12",
        "tags": {}
    }
}

Para obtener más información, consulte Distribuir los tokens de participantes en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

  • Para obtener más información sobre la API, consulte GetPublicKeyla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-stage-session.

AWS CLI

Para obtener una sesión de fase

En el siguiente ejemplo de get-stage-session, se obtiene la sesión de fase para un ID de sesión especificado de un ARN (Nombre de recurso de Amazon) de fase indicada.

aws ivs-realtime get-stage-session \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g

Salida:

{
    "stageSession": {
        "endTime": "2023-04-26T20:36:29+00:00",
        "sessionId": "st-a1b2c3d4e5f6g",
        "startTime": "2023-04-26T20:30:29.602000+00:00"
    }
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulte GetStageSessionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-stage.

AWS CLI

Para obtener la información de configuración de una fase

En el siguiente ejemplo de get-stage, se obtiene la sesión de fase para un ARN (Nombre de recurso de Amazon) de fase especificado.

aws ivs-realtime get-stage \
    --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh

Salida:

{
    "stage": {
        "activeSessionId": "st-a1b2c3d4e5f6g",
        "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
        "autoParticipantRecordingConfiguration": {
            "storageConfigurationArn": "",
            "mediaTypes": [
                "AUDIO_VIDEO"
            ],
            "thumbnailConfiguration": {
                "targetIntervalSeconds": 60,
                "storage": [
                    "SEQUENTIAL"
                ],
                "recordingMode": "DISABLED"
            },
            "recordingReconnectWindowSeconds": 0,
            "hlsConfiguration": {
                "targetSegmentDurationSeconds": 6
            },
            "recordParticipantReplicas": true
        },
        "endpoints": {
            "events": "wss://global.events.live-video.net",
            "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
            "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
            "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
        },
        "name": "test",
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

  • Para obtener más información sobre la API, consulte GetStagela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-storage-configuration.

AWS CLI

Para obtener una configuración del almacenamiento de composición

En el siguiente ejemplo de get-storage-configuration, se obtiene la configuración del almacenamiento de composición especificada por el ARN (Nombre de recurso de Amazon) indicado.

aws ivs-realtime get-storage-configuration \
    --name arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh"

Salida:

{
    "storageConfiguration": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
        "name": "test-sc",
        "s3": {
            "bucketName": "amzn-s3-demo-bucket"
        },
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar import-public-key.

AWS CLI

Para importar una clave pública existente que se utilice para firmar los tokens de los participantes de la fase

En el siguiente ejemplo de import-public-key, se importa una clave pública de un archivo de material para utilizarla para firmar los tokens de los participantes de la fase.

aws ivs-realtime import-public-key \
    --public-key-material="`cat public.pem`"

Salida:

{
    "publicKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
        "name": "",
        "publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----",
        "fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12",
        "tags": {}
    }
}

Para obtener más información, consulte Distribuir los tokens de participantes en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

  • Para obtener más información sobre la API, consulte ImportPublicKeyla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-compositions.

AWS CLI

Para obtener una lista de composiciones

A continuación, se list-compositions enumeran todas las composiciones de tu AWS cuenta, en la AWS región en la que se procesa la solicitud de API.

aws ivs-realtime list-compositions

Salida:

{
    "compositions": [
        {
            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
            "destinations": [
                {
                    "id": "AabBCcdDEefF",
                    "startTime": "2023-10-16T23:25:23+00:00",
                    "state": "ACTIVE"
                }
            ],
            "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
            "startTime": "2023-10-16T23:25:21+00:00",
            "state": "ACTIVE",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/ABcdabCDefgh",
            "destinations": [
                {
                    "endTime": "2023-10-16T23:25:00.786512+00:00",
                    "id": "aABbcCDdeEFf",
                    "startTime": "2023-10-16T23:24:01+00:00",
                    "state": "STOPPED"
                },
                {
                    "endTime": "2023-10-16T23:25:00.786512+00:00",
                    "id": "deEFfaABbcCD",
                    "startTime": "2023-10-16T23:24:01+00:00",
                    "state": "STOPPED"
                }
            ],
            "endTime": "2023-10-16T23:25:00+00:00",
            "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/efghabcdABCD",
            "startTime": "2023-10-16T23:24:00+00:00",
            "state": "STOPPED",
            "tags": {}
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulte ListCompositionsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-encoder-configurations.

AWS CLI

Para enumerar las configuraciones de los codificadores de composición

A continuación, se list-encoder-configurations enumeran todas las configuraciones de los codificadores de composición de su AWS cuenta, en la AWS región en la que se procesa la solicitud de API.

aws ivs-realtime list-encoder-configurations

Salida:

{
    "encoderConfigurations": [
        {
            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh",
            "name": "test-ec-1",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABCefgEFGabc",
            "name": "test-ec-2",
            "tags": {}
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar list-ingest-configurations.

AWS CLI

Obtención de información resumida sobre todas las configuraciones de ingesta

En el siguiente list-ingest-configurations ejemplo, se enumeran todas las configuraciones de ingesta de tu AWS cuenta, en la AWS región en la que se procesa la solicitud de API.

aws ivs-realtime list-ingest-configurations

Salida:

{
    "ingestConfigurations": [
        {
            "name": "",
            "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/XYZuvwSt4567",
            "ingestProtocol": "RTMPS",
            "stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
            "participnatId": "abC789Xyz456",
            "state": "INACTIVE"
            "userId": "",
        }
    ]
}

Para obtener más información, consulte Ingesta de transmisiones de IVS | Transmisión en tiempo real en la Guía del usuario de Servicio de vídeos interactivos de Amazon.

En el siguiente ejemplo de código, se muestra cómo utilizar list-participant-events.

AWS CLI

Ejemplo 1: Para obtener una lista de los eventos que participan en el escenario

En el siguiente ejemplo de list-participant-events, se enumeran todos los eventos de participantes de un ID de participante y un ID de sesión específicos de un ARN (Nombre de recurso de Amazon) de etapa especificado.

aws ivs-realtime list-participant-events \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g \
    --participant-id abCDEf12GHIj

Salida:

{
    "events": [
        {
            "eventTime": "2023-04-26T20:36:28+00:00",
            "name": "LEFT",
            "participantId": "abCDEf12GHIj"
        },
        {
            "eventTime": "2023-04-26T20:36:28+00:00",
            "name": "PUBLISH_STOPPED",
            "participantId": "abCDEf12GHIj"
        },
        {
            "eventTime": "2023-04-26T20:30:34+00:00",
            "name": "JOINED",
            "participantId": "abCDEf12GHIj"
        },
        {
            "eventTime": "2023-04-26T20:30:34+00:00",
            "name": "PUBLISH_STARTED",
            "participantId": "abCDEf12GHIj"
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 2: Para obtener una lista de los eventos que participan en el escenario, incluida la replicación de los participantes, se detiene y se inicia

En el siguiente list-participant-events ejemplo, se enumeran todos los eventos de los participantes para un ID de sesión específico de una etapa específica, ARN (Amazon Resource Name), en la que un participante se replica en otra etapa.

aws ivs-realtime list-participant-events \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g \
    --participant-id abCDEf12GHIj

Salida:

{
    "events": [
        {
            "eventTime": "2025-04-26T20:36:28+00:00",
            "name": "LEFT",
            "participantId": "abCDEf12GHIj"
        },
        {
            "eventTime": "2025-04-26T20:36:28+00:00",
            "name": "PUBLISH_STOPPED",
            "participantId": "abCDEf12GHIj"
        },
        {
            "eventTime": "2025-04-26T20:30:34+00:00",
            "name": "JOINED",
            "participantId": "abCDEf12GHIj"
        },
        {
            "eventTime": "2025-04-26T20:30:34+00:00",
            "name": "PUBLISH_STARTED",
            "participantId": "abCDEf12GHIj"
        },
        {
            "name": "REPLICATION_STARTED",
            "participantId": "abCDEf12GHIj",
            "eventTime": "2025-04-26T20:30:34+00:00",
            "destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
            "destinationSessionId": "st-b1c2d3e4f5g6a"
        },
        {
            "name": "REPLICATION_STOPPED",
            "participantId": "abCDEf12GHIj",
            "eventTime": "2025-04-26T20:32:34+00:00",
            "destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
            "destinationSessionId": "st-b1c2d3e4f5g6a"
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

  • Para obtener más información sobre la API, consulte la Referencia ListParticipantEventsde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-participant-replicas.

AWS CLI

Para obtener una lista de las réplicas de los participantes en el escenario

En el siguiente list-participant-replicas ejemplo, se enumeran todos los participantes de la etapa que se han replicado desde la etapa de origen ARN (Amazon Resource Name) especificada a otra etapa.

aws ivs-realtime list-participant-replicas \
    --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --participant-id abCDEf12GHIj

Salida:

{
    "replicas": [
        {
            "sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
            "participantId": "abCDEf12GHIj",
            "sourceSessionId": "st-a1b2c3d4e5f6g",
            "destinationStageArn": "arn:aws:ivs:us-west-2:012345678901:stage/ABCDabcdefgh",
            "destinationSessionId": "st-b1c2d3e4f5g6a",
            "replicationState": "ACTIVE"
        }
    ]
}

Para obtener más información, consulte IVS Participant Replication en la Guía del usuario de Amazon IVS Real-Time Streaming.

En el siguiente ejemplo de código, se muestra cómo utilizar list-participants.

AWS CLI

Ejemplo 1: Para obtener una lista de los participantes del escenario

En el siguiente ejemplo de list-participants, se enumeran todos los participantes de un ID de sesión indicado de un ARN (Nombre de recurso de Amazon) de etapa especificado.

aws ivs-realtime list-participants \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g

Salida:

{
    "participants": [
        {
            "firstJoinTime": "2023-04-26T20:30:34+00:00",
            "participantId": "abCDEf12GHIj",
            "published": true,
            "recordingState": "STOPPED",
            "state": "DISCONNECTED",
            "userId": ""
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 2: Para obtener una lista de los participantes de la etapa, cuando un participante ha sido reproducido en otra etapa

En el siguiente list-participants ejemplo, se enumeran todos los participantes de un ID de sesión específico de un ARN (Amazon Resource Name) de una etapa específica, cuando un participante se ha replicado en otra etapa.

aws ivs-realtime list-participants \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g

Salida:

{
    "participants": [
        {
            "firstJoinTime": "2023-04-26T20:30:34+00:00",
            "participantId": "abCDEf12GHIj",
            "published": true,
            "recordingState": "STOPPED",
            "state": "DISCONNECTED",
            "userId": "",
            "replicationState": "ACTIVE",
            "replicationType": "SOURCE",
            "sourceStageArn": "",
            "sourceSessionId": ""
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 3: Para obtener una lista de los participantes de la etapa, cuando se ha replicado a un participante de otra etapa

En el siguiente list-participants ejemplo, se enumeran todos los participantes de un ID de sesión específico de un ARN (Amazon Resource Name) de una etapa específica, cuando un participante se ha replicado desde otra etapa.

aws ivs-realtime list-participants \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --session-id st-a1b2c3d4e5f6g

Salida:

{
    "participants": [
        {
            "firstJoinTime": "2023-04-26T20:30:34+00:00",
            "participantId": "abCDEf12GHIj",
            "published": true,
            "recordingState": "STOPPED",
            "state": "DISCONNECTED",
            "userId": "",
            "replicationState": "ACTIVE",
            "replicationType": "REPLICA",
            "sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
            "sourceSessionId": "st-a1b2c3d4e5f6g"
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

  • Para obtener más información sobre la API, consulte la Referencia ListParticipantsde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-public-keys.

AWS CLI

Para enumerar las claves públicas existentes disponibles para firmar los tokens de los participantes de la fase

En el siguiente list-public-keys ejemplo, se enumeran todas las claves públicas disponibles para firmar los tokens de los participantes en la fase, en la AWS región en la que se procesa la solicitud de API.

aws ivs-realtime list-public-keys

Salida:

{
    "publicKeys": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
            "name": "",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/3bcdABCDefg4",
            "name": "",
            "tags": {}
        }
    ]
}

Para obtener más información, consulte Distribuir los tokens de participantes en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

  • Para obtener más información sobre la API, consulte ListPublicKeysla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-stage-sessions.

AWS CLI

Para obtener una lista de las sesiones de la fase

En el siguiente ejemplo de list-stage-sessions, se enumeran todas las sesiones de un ARN (Nombre de recurso de Amazon) de etapa especificado.

aws ivs-realtime list-stage-sessions \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh

Salida:

{
    "stageSessions": [
        {
            "endTime": "2023-04-26T20:36:29+00:00",
            "sessionId": "st-a1b2c3d4e5f6g",
            "startTime": "2023-04-26T20:30:29.602000+00:00"
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulte ListStageSessionsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-stages.

AWS CLI

Para obtener información resumida sobre todas las fases

En el siguiente list-stages ejemplo, se enumeran todas las etapas de tu AWS cuenta, en la AWS región en la que se procesa la solicitud de API.

aws ivs-realtime list-stages

Salida:

{
    "stages": [
        {
            "activeSessionId": "st-a1b2c3d4e5f6g",
            "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
            "name": "stage1",
            "tags": {}
        },
        {
            "activeSessionId": "st-a123bcd456efg",
            "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcd1234ABCD",
            "name": "stage2",
            "tags": {}
        },
        {
            "activeSessionId": "st-abcDEF1234ghi",
            "arn": "arn:aws:ivs:us-west-2:123456789012:stage/ABCD1234efgh",
            "name": "stage3",
            "tags": {}
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulta ListStagesla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-storage-configurations.

AWS CLI

Para enumerar las configuraciones de almacenamiento de composición

A continuación, se list-storage-configurations enumeran todas las configuraciones de almacenamiento de composición de su AWS cuenta, en la AWS región en la que se procesa la solicitud de API.

aws ivs-realtime list-storage-configurations

Salida:

{
    "storageConfigurations": [
        {
            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
            "name": "test-sc-1",
            "s3": {
                "bucketName": "amzn-s3-demo-bucket-1"
            },
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABCefgEFGabc",
            "name": "test-sc-2",
            "s3": {
                "bucketName": "amzn-s3-demo-bucket-2"
            },
            "tags": {}
        }
    ]
}

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

En el siguiente ejemplo de código, se muestra cómo utilizar start-composition.

AWS CLI

Ejemplo 1: iniciar una composición con los ajustes de diseño predeterminados

En el siguiente ejemplo de start-composition, se inicia una composición para la etapa especificada que se va a transmitir a las ubicaciones indicadas.

aws ivs-realtime start-composition \
    --stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
    --destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
        {"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
        "recordingConfiguration": {"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}, \
        "storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]'

Salida:

{
    "composition": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
        "destinations": [
            {
                "configuration": {
                    "channel": {
                        "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
                        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                    },
                    "name": ""
                },
                "id": "AabBCcdDEefF",
                "state": "STARTING"
            },
            {
                "configuration": {
                    "name": "",
                    "s3": {
                        "encoderConfigurationArns": [
                            "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                        ],
                        "recordingConfiguration": {
                            "format": "HLS",
                            "hlsConfiguration": {
                                "targetSegmentDurationSeconds": 5
                            }
                        },
                        "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
                    }
                },
                "detail": {
                    "s3": {
                        "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
                    }
                },
                "id": "GHFabcgefABC",
                "state": "STARTING"
            }
        ],
        "layout": {
            "grid": {
                "featuredParticipantAttribute": ""
                "gridGap": 2,
                "omitStoppedVideo": false,
                "videoAspectRatio": "VIDEO",
                "videoFillMode": ""
            }
        },
        "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
        "startTime": "2023-10-16T23:24:00+00:00",
        "state": "STARTING",
        "tags": {}
    }
}

Para obtener más información, consulte Grabación compuesta de IVS | Transmisión en tiempo real en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

Ejemplo 2: iniciar una composición con los ajustes de diseño predeterminados

En el siguiente ejemplo de start-composition, se inicia una composición para la etapa especificada que se va a transmitir a las ubicaciones indicadas con el diseño predeterminado.

aws ivs-realtime start-composition \
    --stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
    --destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
        {"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
        "storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]' \
    --layout pip='{featuredParticipantAttribute="abcdefg"}'

Salida:

{
    "composition": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs",
        "destinations": [
            {
                "configuration": {
                    "channel": {
                        "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
                        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                    },
                    "name": ""
                },
                "id": "AabBCcdDEefF",
                "state": "STARTING"
            },
            {
                "configuration": {
                    "name": "",
                    "s3": {
                        "encoderConfigurationArns": [
                            "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                        ],
                        "recordingConfiguration": {
                            "format": "HLS",
                            "hlsConfiguration": {
                                "targetSegmentDurationSeconds": 2
                            }
                        },
                        "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
                    }
                },
                "detail": {
                    "s3": {
                        "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
                    }
                },
                "id": "GHFabcgefABC",
                "state": "STARTING"
            }
        ],
        "layout": {
            "pip": {
                "featuredParticipantAttribute": "abcdefg",
                "gridGap": 0,
                "omitStoppedVideo": false,
                "pipBehavior": "STATIC",
                "pipOffset": 0,
                "pipParticipantAttribute": "",
                "pipPosition": "BOTTOM_RIGHT",
                "videoFillMode": "COVER"
            }
        },
        "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
        "startTime": "2023-10-16T23:24:00+00:00",
        "state": "STARTING",
        "tags": {}
    }
}

Para obtener más información, consulte Grabación compuesta de IVS | Transmisión en tiempo real en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

Ejemplo 3: inicio de una composición con la grabación de miniaturas habilitada

En el siguiente ejemplo de start-composition, se inicia una composición para la etapa especificada que se va a transmitir a las ubicaciones indicadas con la grabación de miniaturas habilitada.

aws ivs-realtime start-composition \
    --stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
    --destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
        {"s3": {"encoderConfigurationArns": ["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
        "storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", \
        "thumbnailConfigurations": [{"storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}]}}]'

Salida:

{
    "composition": {
        "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
        "destinations": [
            {
                "configuration": {
                    "channel": {
                        "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
                        "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                    },
                    "name": ""
                },
                "id": "AabBCcdDEefF",
                "state": "STARTING"
            },
            {
                "configuration": {
                    "name": "",
                    "s3": {
                        "encoderConfigurationArns": [
                            "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
                        ],
                        "recordingConfiguration": {
                            "format": "HLS",
                            "hlsConfiguration": {
                                "targetSegmentDurationSeconds": 2
                            }
                        },
                        "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
                        "thumbnailConfigurations": [
                           {
                              "targetIntervalSeconds": 60,
                              "storage": [
                                  "SEQUENTIAL"
                              ]
                           }
                        ]
                    }
                },
                "detail": {
                    "s3": {
                        "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
                    }
                },
                "id": "GHFabcgefABC",
                "state": "STARTING"
            }
        ],
        "layout": {
            "grid": {
                "featuredParticipantAttribute": ""
                "gridGap": 2,
                "omitStoppedVideo": false,
                "videoAspectRatio": "VIDEO",
                "videoFillMode": ""
            }
        },
        "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
        "startTime": "2023-10-16T23:24:00+00:00",
        "state": "STARTING",
        "tags": {}
    }
}

Para obtener más información, consulte Grabación compuesta de IVS | Transmisión en tiempo real en la Guía del usuario de Transmisión en tiempo real de Amazon IVS.

  • Para obtener más información sobre la API, consulte StartCompositionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar start-participant-replication.

AWS CLI

Para empezar a replicar a un participante de una etapa a otra

El siguiente start-participant-replication ejemplo replica a un participante de una etapa de origen a una etapa de destino, y cada etapa se especifica mediante su ARN (Amazon Resource Name).

aws ivs-realtime start-participant-replication \
    --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
    --participant-id abCDEf12GHIj

Salida:

{
    "accessControlAllowOrigin": "*",
    "accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
    Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
    x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
    "cacheControl": "no-store, no-cache",
    "contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
    "strictTransportSecurity": "max-age:47304000; includeSubDomains",
    "xContentTypeOptions": "nosniff",
    "xFrameOptions": "DENY"
}

Para obtener más información, consulte IVS Participant Replication en la Guía del usuario de Amazon IVS Real-Time Streaming.

En el siguiente ejemplo de código, se muestra cómo utilizar stop-composition.

AWS CLI

Para detener una composición

En el siguiente ejemplo de stop-composition, se detiene la composición especificada por el ARN (Nombre de recurso de Amazon) indicado.

aws ivs-realtime stop-composition \
    --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"

Este comando no genera ninguna salida.

Para obtener más información, consulte Habilitación de varios hosts en una transmisión de Amazon IVS en la Guía del usuario de Amazon IVS.

  • Para obtener más información sobre la API, consulte StopCompositionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar stop-participant-replication.

AWS CLI

Para dejar de replicar a un participante de una etapa a otra

El siguiente stop-participant-replication ejemplo detiene la replicación de un participante desde una etapa de origen a una etapa de destino, y cada etapa se especifica mediante su ARN (Amazon Resource Name).

aws ivs-realtime stop-participant-replication \
    --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
    --participant-id abCDEf12GHIj

Salida:

{
    "accessControlAllowOrigin": "*",
    "accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
    Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
    x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
    "cacheControl": "no-store, no-cache",
    "contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
    "strictTransportSecurity": "max-age:47304000; includeSubDomains",
    "xContentTypeOptions": "nosniff",
    "xFrameOptions": "DENY"
}

Para obtener más información, consulte IVS Participant Replication en la Guía del usuario de Amazon IVS Real-Time Streaming.

En el siguiente ejemplo de código, se muestra cómo utilizar update-ingest-configuration.

AWS CLI

Actualización de una configuración de ingesta

En el siguiente ejemplo de update-inegst-configuration, se actualiza una configuración de ingesta para adjuntarla a una etapa.

aws ivs-realtime update-ingest-configuration \
    --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
    --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh

Salida:

{
    "ingestConfiguration": {
        "name": "ingest1",
        "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
        "ingestProtocol": "RTMPS",
        "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
        "stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
        "participantId": "xyZ654abC321",
        "state": "INACTIVE",
        "userId": "",
        "tags": {}
    }
}

Para obtener más información, consulte Ingesta de transmisiones de IVS | Transmisión en tiempo real en la Guía del usuario de Servicio de vídeos interactivos de Amazon.

En el siguiente ejemplo de código, se muestra cómo utilizar update-stage.

AWS CLI

Ejemplo 1: Para actualizar la configuración de una etapa

En el siguiente ejemplo de update-stage, se actualiza una etapa para un ARN de etapa específico para actualizar el nombre de la etapa y configurar la grabación individual de los participantes con la grabación de miniaturas habilitada.

aws ivs-realtime update-stage \
    --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
        "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}} \
        "hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \
    --name stage1a

Salida:

{
    "stage": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
        "autoParticipantRecordingConfiguration": {
            "mediaTypes": [
                "AUDIO_VIDEO"
            ],
            "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
            "thumbnailConfiguration": {
                "targetIntervalSeconds": 60,
                "storage": [
                    "SEQUENTIAL"
                ],
                "recordingMode": "INTERVAL"
            },
            "recordingReconnectWindowSeconds": 100,
            "hlsConfiguration": {
                "targetSegmentDurationSeconds": 5
            },
            "recordParticipantReplicas": true
        },
        "endpoints": {
            "events": "wss://global.events.live-video.net",
            "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
            "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
            "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
        },
        "name": "stage1a",
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

Ejemplo 2: Para actualizar la configuración de una etapa, incluida la desactivación de la grabación de réplicas de los participantes

El siguiente update-stage ejemplo actualiza una etapa para un ARN de etapa específico para actualizar el nombre de la etapa y configurar la grabación individual de los participantes con la grabación de miniaturas habilitada y la grabación de réplicas de participantes deshabilitada.

aws ivs-realtime update-stage \
    --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
    --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
        "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}, "recordParticipantReplicas":false} \
        "hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \
    --name stage1a

Salida:

{
    "stage": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
        "autoParticipantRecordingConfiguration": {
            "mediaTypes": [
                "AUDIO_VIDEO"
            ],
            "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
            "thumbnailConfiguration": {
                "targetIntervalSeconds": 60,
                "storage": [
                    "SEQUENTIAL"
                ],
                "recordingMode": "INTERVAL"
            },
            "recordingReconnectWindowSeconds": 100,
            "hlsConfiguration": {
                "targetSegmentDurationSeconds": 5
            },
            "recordParticipantReplicas": false
        },
        "endpoints": {
            "events": "wss://global.events.live-video.net",
            "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
            "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
            "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
        },
        "name": "stage1a",
        "tags": {}
    }
}

Para obtener más información, consulte Habilitación de varios hosts en un flujo de Amazon IVS en la Guía del usuario de Transmisión de baja latencia de Amazon IVS.

  • Para obtener más información sobre la API, consulte la Referencia UpdateStagede AWS CLI comandos.