AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Classes

NameDescription
Class AmazonIVSRealTimeClient

Implementation for accessing IVSRealTime

The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP API and an AWS EventBridge event stream for responses. JSON is used for both requests and responses, including errors.

Key Concepts

  • Stage — A virtual space where participants can exchange video in real time.

  • Participant token — A token that authenticates a participant when they join a stage.

  • Participant object — Represents participants (people) in the stage and contains information about them. When a token is created, it includes a participant ID; when a participant uses that token to join a stage, the participant is associated with that participant ID. There is a 1:1 mapping between participant tokens and participants.

For server-side composition:

  • Composition process — Composites participants of a stage into a single video and forwards it to a set of outputs (e.g., IVS channels). Composition operations support this process.

  • Composition — Controls the look of the outputs, including how participants are positioned in the video.

For more information about your IVS live stream, also see Getting Started with Amazon IVS Real-Time Streaming.

Tagging

A tag is a metadata label that you assign to an AWS resource. A tag comprises a key and a value, both set by you. For example, you might set a tag as topic:nature to label a particular video category. See Best practices and strategies in Tagging AWS Resources and Tag Editor for details, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS stages has no service-specific constraints beyond what is documented there.

Tags can help you identify and organize your AWS resources. For example, you can use the same tag for different resources to indicate that they are related. You can also use tags to manage access (see Access Tags).

The Amazon IVS real-time API has these tag-related operations: TagResource, UntagResource, and ListTagsForResource. The following resource supports tagging: Stage.

At most 50 tags can be applied to a resource.

Class AmazonIVSRealTimeConfig

Configuration for accessing Amazon IVSRealTime service

Class AmazonIVSRealTimeDefaultConfiguration

Configuration for accessing Amazon IVSRealTime service

Class AmazonIVSRealTimeException

Common exception for the IVSRealTime service.

Class AmazonIVSRealTimeRequest

Base class for IVSRealTime operation requests.

Class CompositionState

Constants used for properties of type CompositionState.

Class DestinationState

Constants used for properties of type DestinationState.

Class EventErrorCode

Constants used for properties of type EventErrorCode.

Class EventName

Constants used for properties of type EventName.

Class IngestConfigurationState

Constants used for properties of type IngestConfigurationState.

Class IngestProtocol

Constants used for properties of type IngestProtocol.

Class ParticipantProtocol

Constants used for properties of type ParticipantProtocol.

Class ParticipantRecordingFilterByRecordingState

Constants used for properties of type ParticipantRecordingFilterByRecordingState.

Class ParticipantRecordingMediaType

Constants used for properties of type ParticipantRecordingMediaType.

Class ParticipantRecordingState

Constants used for properties of type ParticipantRecordingState.

Class ParticipantState

Constants used for properties of type ParticipantState.

Class ParticipantTokenCapability

Constants used for properties of type ParticipantTokenCapability.

Class PipBehavior

Constants used for properties of type PipBehavior.

Class PipPosition

Constants used for properties of type PipPosition.

Class RecordingConfigurationFormat

Constants used for properties of type RecordingConfigurationFormat.

Class ThumbnailRecordingMode

Constants used for properties of type ThumbnailRecordingMode.

Class ThumbnailStorageType

Constants used for properties of type ThumbnailStorageType.

Class VideoAspectRatio

Constants used for properties of type VideoAspectRatio.

Class VideoFillMode

Constants used for properties of type VideoFillMode.

Interfaces

NameDescription
Interface IAmazonIVSRealTime

Interface for accessing IVSRealTime

The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP API and an AWS EventBridge event stream for responses. JSON is used for both requests and responses, including errors.

Key Concepts

  • Stage — A virtual space where participants can exchange video in real time.

  • Participant token — A token that authenticates a participant when they join a stage.

  • Participant object — Represents participants (people) in the stage and contains information about them. When a token is created, it includes a participant ID; when a participant uses that token to join a stage, the participant is associated with that participant ID. There is a 1:1 mapping between participant tokens and participants.

For server-side composition:

  • Composition process — Composites participants of a stage into a single video and forwards it to a set of outputs (e.g., IVS channels). Composition operations support this process.

  • Composition — Controls the look of the outputs, including how participants are positioned in the video.

For more information about your IVS live stream, also see Getting Started with Amazon IVS Real-Time Streaming.

Tagging

A tag is a metadata label that you assign to an AWS resource. A tag comprises a key and a value, both set by you. For example, you might set a tag as topic:nature to label a particular video category. See Best practices and strategies in Tagging AWS Resources and Tag Editor for details, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS stages has no service-specific constraints beyond what is documented there.

Tags can help you identify and organize your AWS resources. For example, you can use the same tag for different resources to indicate that they are related. You can also use tags to manage access (see Access Tags).

The Amazon IVS real-time API has these tag-related operations: TagResource, UntagResource, and ListTagsForResource. The following resource supports tagging: Stage.

At most 50 tags can be applied to a resource.