Document History - Amazon Interactive Video Service

Document History

User Guide Changes

ChangeDescriptionDate

Player SDK 1.10.0 release: Web and Android

Updated version number and artifact links for the new release, in Player guides: Web, Android, Video.js Integration, and JW Player Integration.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

Also see the Amazon IVS Release Notes for this release.

May 24, 2022

Service Quotas

Added call-rate quotas for GetStreamSession and ListStreamSessions. (These IVS endpoints were added previously, when Stream Health was launched.)

May 16, 2022

iOS Player Guide

In "Known Issues and Workarounds," deleted a bullet about iOS 10, which is no longer supported:

  • iOS 10 devices may experience a crash when returning from background.

    Workaround: Set the layer’s player property to nil before entering the background.

May 10, 2022

Broadcast SDK: Custom Image Sources

Added a bullet for a new CIFilter implementation in the sample iOS app.

May 10, 2022

Service Quotas for Amazon IVS Chat

In "Other Quotas," added message review handler timeout period.

May 6, 2022

Web Player Guide

In "Content Security Policy," added domains for video streams from third-party CDNs (*.akamaized.net and *.ext.cloudfront.live.hls.ttvnw.net).

April 29, 2022

Video.js Player Guide

In "Events," deleted MetadataEventType (which is no longer available) from the list of allowable event values.

April 29, 2022

Security policy updates

In Identity-Based Policy Examples, changed the console policy (added Chat, lambda, and Amazon CloudWatch) and the introductory text to it.

April 29, 2022

Private channels

In Generate and Sign Playback Tokens, specified that the exp timestamp value in the payload field of the token schema is UTC.

April 29, 2022

OBS Studio setup

IVS Getting Started – In Streaming with OBS Studio, clarified how to specify the server and stream key, and added steps to set video resolution, bitrate, and keyframe interval.

April 29, 2022

Stream Health updates

Monitoring Amazon IVS Live Stream Health – In "Console Instructions," noted that charts of the high-resolution CloudWatch metrics are available in the stream session details pages. In "Filter Streams by Health," added "CloudWatch Health Dimension for ConcurrentStreams."

Monitoring Amazon IVS with Amazon CloudWatch – A new dimension (Health) was added to the ConcurrentStreams metric, to filter the results by channel health.

April 28, 2022

Amazon IVS Chat

Initial release of this new functionality. New and updated information is accessible from the Amazon IVS documentation landing page:

April 26, 2022

iOS Player 1.8.2 release

Updated version number and artifact links for the new release, in the iOS Player Guide.

On the Amazon IVS documentation landing page, updated the iOS Player SDK Reference link to point to the new version.

April 22, 2022

Manual SDK installation

In the "Getting Started" > "Install the Library" section of Broadcast SDK: Android and Player: Android Guide, added a sentence about installing manually.

April 19, 2022

Broadcast SDK 1.4.0 release

Updated version number and artifact links for the new release, in the broadcast SDK guide: Android, iOS.

Added a new page on Broadcast SDK: Custom Image Sources.

On the Amazon IVS documentation landing page, updated the broadcast SDK Reference links to point to the new version.

Also see the Amazon IVS Release Notes for this release.

April 19, 2022

iOS Player 1.8.1 release

Updated version number and artifact links for the new release, in the iOS Player Guide.

On the Amazon IVS documentation landing page, updated the iOS Player SDK Reference link to point to the new versions.

March 31, 2022

Device support for Android player

In the Android Player Guide, clarified which native Android devices are supported (phones and tablets). In the Player overview, added a Supported Devices table column in the "Native Platform" section.

March 23, 2022

Using Amazon EventBridge with Amazon IVS

Modified the Session Ended event and updated its description. Also clarified the event descriptions of Session Created and Stream End.

March 18, 2022

Player Video.js Integration

In "Setup with Script Tag," step 1, added a closing </script> to the example.

March 4, 2022

Broadcast SDK 1.3.0 release

Updated version number and artifact links for the new release, in the broadcast SDK guide: Android, iOS.

On the Amazon IVS documentation landing page, updated the broadcast SDK Reference links to point to the new version.

Also see the Amazon IVS Release Notes for this release.

March 3, 2022

Player 1.8.0 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, Video.js Integration, and JW Player Integration.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

Also see the Amazon IVS Release Notes for this release.

March 1, 2022

Using Amazon EventBridge with Amazon IVS

For the Recording End Failure event, added an example failure case: the attempt to write a master playlist fails.

February 10, 2022

Using Amazon EventBridge with Amazon IVS

For the Recording Start event, added a note that it takes awhile before manifest files and video segments are written.

February 9, 2022

Broadcast SDK: Android 1.2.1 release

Updated version number and artifact links for the new release, in the broadcast SDK guide: Android.

On the Amazon IVS documentation landing page, updated the broadcast SDK Reference link to point to the new version.

Also see the Amazon IVS Release Notes for this release.

February 3, 2022

React Native wrapper for Player SDK

In the Player Android Guide and Player iOS Guide, added a link to GitHub code and documentation for the new React Native wrapper.

January 27, 2022

React Native wrapper for Player SDK

In the Player Android Guide and Player iOS Guide, added a link to GitHub code and documentation for the new React Native wrapper.

January 27, 2022

Web Player CSP change

In "Hosting Assets on a Separate Origin," add information for Chrome.

January 25, 2022

Setting Up Private Channels

In "Token Schema," added information about support for multiple domains and wildcard domains in the access-control-allow-origin token-payload field.

January 24, 2022

Web Player 1.7.0 Release Notes

In the Release Notes, updated the bullet on setInitialBufferDuration() to say it does not work on iOS mobile browsers.

January 21, 2022

Player 1.7.0 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, Video.js Integration, and JW Player Integration.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

Also see the Amazon IVS Release Notes for this release.

January 20, 2022

R2S3 thumbnail configuration release

In Getting Started with Amazon IVS, we updated Step 3: Create a Channel with Optional Recording.

In Auto-Record to Amazon S3, we added a note to "Recording Contents" about modifying the thumbnails folder, added a new "Thumbnails" section, and changed the information about the thumbnails and path fields in "JSON Metadata Files."

January 18, 2022

Android Player Guide

In "Install the Library," deleted the jcenter() line, as JCenter is deprecated.

January 7, 2022

iOS Player

Added a "Known Issue" about the player crashing when testing against the arm64e architecture.

December 20, 2021

Broadcast SDK 1.2.0 release

Updated version number and artifact links for the new release, in all broadcast SDK guides: Android, iOS.

On the Amazon IVS documentation landing page, updated the broadcast SDK Reference links to point to the new versions.

Also see the Amazon IVS Release Notes for this release.

December 9, 2021

Using Amazon EventBridge with Amazon IVS

Expanded the descriptions of stream/session start/create/end events and added usage suggestions.

December 3, 2021

Streaming Configuration

For streaming from Android and iOS, replaced the information on Larix Broadcaster with a pointer to documentation on the Amazon IVS broadcast SDK.

November 24, 2021

Broadcasting: SDK for Android Guide

Added an issue for Android 5/6/7 devices, which can use only the system’s default microphone, hence cannot receive the broadcast SDK's onDeviceAdded and onDeviceRemoved callbacks for microphones.

November 24, 2021

Player 1.6 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, Video.js Integration, and JW Player Integration.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

Also see the Amazon IVS Release Notes for this release.

November 23, 2021

Amazon IVS Player

At the end of the introductory text, added a paragraph about casting support and a pointer to Amazon IVS Broadcast SDK documentation.

November 23, 2021

Monitoring Amazon IVS Live Stream Health

New User Guide page for new Amazon IVS functionality. For Stream Health, we also:

November 18, 2021

Using Amazon EventBridge with Amazon IVS

Updated the description of the Recording Start event.

November 5, 2021

Broadcasting: SDK for iOS Guide

Add a "Known Issue" for AirPods connected to an iOS 12 device.

November 4, 2021

Stream with FFmpeg

In Streaming Configuration, clarified that FFmpeg can be used with many OSs/devices (not just Windows Desktop) and fixed the format of the example in the Webcam bullet.

November 3, 2021

Broadcast SDK (Android and iOS) 1.1.0 release

Updated version number and artifact links for the new release, in broadcast SDK guides: Android and iOS. In Android, there are new setPosition coordinates in "Create a Broadcast Configuration." In iOS, there is a new advanced use case ("Use Background Video"), slot-position changes in "Create a Broadcast Configuration," and a new "Known Issue."

On the Amazon IVS documentation landing page, updated the broadcast SDK Reference links to point to the new versions.

Added a new page, Broadcasting: Mixer Guide, to the documentation for this feature.

Also see the Amazon IVS Release Notes for this release.

October 20, 2021

Setting Up Private Channels

In "Token Schema," updated access-control-allow-origin definition to refer to "origin" instead of "domain."

October 11, 2021

Android Player 1.5.1 release

Bug-fix release; see Amazon IVS Release Notes. Also updated version-number references in links and text in the Android Player Guide.

September 29, 2021

Player 1.5.0 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, Video.js Integration, and JW Player Integration.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

Also see the Amazon IVS Release Notes for this release.

September 28, 2021

Streaming Configuration

In "Audio Settings," specified a minimum bitrate, 96 Kbps.

September 22, 2021

Getting Started with Amazon IVS

In "Step 4: Set Up Streaming Software," added a note about disconnecting if no data is sent for 30 seconds.

September 20, 2021

Identity-based policy example

In Amazon IVS Security, fixed a typo in the example in Access an Amazon IVS Channel: added ending punctuation (}]}).

September 17, 2021

SDK sizes for Player 1.4.1 and 1.4.0

In the Release Notes for Player 1.4.1 and 1.4.0, we made corrections to the tables of mobile SDK sizes.

September 16, 2021

Player 1.4.1 release

Bug-fix release; see Amazon IVS Release Notes. Also updated version number and artifact links in all player guides: Web, Android, iOS, Video.js Integration, and JW Player Integration.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

In Streaming Configuration, updated the information on Closed Captioning.

September 8, 2021

Broadcasting: SDK for Android Guide

In "Set the ImagePreviewView for Preview," made minor text clarifications. In "Swap Cameras," fixed two typos. In "Create a Broadcast Configuration," deleted the line referencing video.setDefaultAspectMode, which is not usable now.

September 1, 2021

Streaming configuration with FFmpeg

Modified settings for capturing video files. Specifically, -g 120 was changed to -force_key_frames expr:gte(t,n_forced*2). This causes the encoder to insert a keyframe every 2 seconds, regardless of source-input frame rate.

August 23, 2021

Amazon IVS Player: SDK for Web Guide

Added new "Known Issue" for Pixel 4/4a mobile browsers.

August 20, 2021

Amazon IVS Player: Video.js Integration

In "Sample Code," updated the version number to 7.14.3. There is a security vulnerability in versions of Video.js earlier than 7.14.3.

August 19, 2021

Streaming Configuration

For the STANDARD channel type, added a note that audio is transcoded only for renditions 360p and below; above that, audio is passed through.

August 18, 2021

Getting Started with Amazon IVS

In "Step 2: Set Up IAM Permissions," added steps to attach the policy to an existing user. This new procedure is in addition to the old procedure, which is for creating a new user and attaching a policy to that user.

August 11, 2021

Player 1.4.0 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, Video.js Integration, and JW Player Integration.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

Also see the Amazon IVS Release Notes for this release.

August 10, 2021

Amazon IVS Player: SDK for Web Guide

In "Setup With NPM," added a note about hosting player static assets from your own domain.

July 30, 2021

Getting Started with Amazon IVS

In "Step 2: Set Up IAM Permissions," updated policy information and instructions.

In "Step 3: Create a Channel with Optional Recording," added a section, "Auto-Record to S3" (to replace a prior paragraph).

In "Step 4: Set up Streaming Software," added a section, "Streaming with the Amazon IVS Broadcast SDK."

July 29, 2021

Auto-Record to S3

Added a new section, “Playback of Recorded Content from Private Buckets.” Also updated the introduction to this page.

July 28, 2021

Amazon IVS Broadcast SDK (Android and iOS)

Initial release of the broadcast SDK for Android and iOS. See the documentation under “Amazon IVS Broadcast SDK,” a new section of the Amazon IVS documentation landing page.

July 27, 2021

Amazon IVS Player

Updated Desktop Browsers to indicate Amazon IVS Player 1.3.0 support for ultra-low latency on new versions of Safari for macOS.

July 14, 2021

Amazon IVS Service Quotas

For the PutMetadata endpoint, added a limit of 155 TPS per account.

June 29, 2021

ivs.rocks

On the Amazon IVS User Guide landing page, added a link to and brief description of ivs.rocks.

June 25, 2021

Player Browser & Platform Requirements

For the Amazon IVS Player, added links to sites listing the latest versions of supported browsers.

June 25, 2021

Streaming Configuration

In "Channel Types," updated definitions of channel types. For STANDARD channels, resolution can be up to 1080p; for BASIC channels, 480p. (The prior definitions were only in terms of vertical resolution.)

June 17, 2021

Costs

Added a new page on costs.

June 17, 2021

Amazon IVS Player: SDK for Android Guide

Added a new "Permissions" section.

June 17, 2021

Player mobile-browser support

In Mobile Browsers, added information about support for Chrome for iPadOS and Safari for iPadOS.

June 14, 2021

Player SDK size

Added a new "SDK Size" section to the Android and iOS Player SDK guides.

June 11, 2021

Amazon IVS Player: SDK for Web Guide

Added two "Known Issues" when playing content on an iOS mobile browser (with player.getQualities() and player.getLiveLatency() calls).

June 9, 2021

Supported regions and service endpoints

Replace lists of supported regions with a link to the Amazon IVS page in the AWS General Reference, which is updated automatically when support for new regions is added. Changes were made on the Monitoring Amazon IVS with Amazon CloudWatch page.

June 8, 2021

Amazon IVS Player issues

In "Known Issues and Workarounds," for the Web, Android, and iOS Player, asked customers to report all issues to Support. Also added an issue with Android 11 emulators.

June 4, 2021

Android and iOS Player 1.3.3 release

Bug-fix release; see Amazon IVS Release Notes. Also updated version-number references in links and text in the Android Player Guide and iOS Player Guide.

The Amazon IVS documentation landing page always points to the most current versions of the Player SDK References.

June 1, 2021

Setting Up Private Channels

Updated "Generate and Sign Playback Tokens" (information on creating the signature and steps in "Instructions").

May 26, 2021

Global versus regional

Moved "Global Solution, Regional Control" from Getting Started with Amazon IVS to What Is Amazon IVS.

May 21, 2021

Amazon IVS Player: Video.js Integration

In "Sample Code," updated the Cloudflare version number from 7.6.6 to 7.11.4.

May 20, 2021

Android Player 1.3.2 release

Bug-fix release; see Amazon IVS Release Notes. Also updated version-number references in links and text in the Android Player Guide.

May 19, 2021

Amazon IVS Service Quotas

Minor wording changes. Deleted information about maximum number of tags; this was moved to the API Reference.

May 12, 2021

Amazon IVS Release Notes

Added a note for Web Player 1.3.1: the 1.3.0 NPM package exists but does not work.

May 11, 2021

Using Amazon EventBridge with Amazon IVS

Updated stream_id to be a "sanitized" value in all relevant examples.

May 10, 2021

Amazon IVS Player: SDK for Web Guide

Added a known issue and workaround, for player.seekTo() calls when playing recorded content on an iOS mobile browser.

May 10, 2021

Streaming Configuration

Renamed the Encoder Configuration page to Streaming Configuration.

May 6, 2021

Using Amazon EventBridge with Amazon IVS

In "Examples: Recording State Change," added the recording_duration_ms field, changed the example value of the recording_s3_key_prefix field, and changed the value of the recording_status_reason field.

May 5, 2021

Player 1.3 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, Video.js Integration, and JW Player Integration. For Android, added mavenCentral() to "Install the Library."

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

In Player 1.3.0 and later, timed metadata is now supported on Chrome and Safari for iOS. This is noted in the Amazon IVS Player SDK overview (table on "Mobile Browsers") and Embedding Metadata within a Video Stream (in "Consuming Metadata").

Also see the Amazon IVS Release Notes for this release.

May 5, 2021

Amazon IVS Service Quotas

Added a new section, "Service Quotas Integration with CloudWatch Usage Metrics."

April 26, 2021

Maximum duration of a stream

In Getting Started with Amazon IVS ("Step 4: Set Up Streaming Software"), added a note about the maximum duration of a stream, 48 hours.

April 23, 2021

IAM policy changes

Made several IAM policy changes:

April 22, 2021

New CloudWatch metrics

Various doc changes for the release of new CloudWatch metrics:

April 13, 2021

Auto-Record to S3

New User Guide page for this new Amazon IVS functionality. This also affects several existing documents:

April 7, 2021

Amazon IVS Streaming Configuration

In "Closed Captioning," clarified that the Player SDKs support only 1 language, not multi-track captions playback.

March 29, 2021

Global versus regional

In What is Amazon IVS, added a new section, "Global Solution, Regional Control," to clarify what is global versus regional. In Getting Started with Amazon IVS, mentioned selecting a region, in the instructions for creating a channel.

March 25, 2021

EventBridge event latency & IDR/Keyframe encoder setting

Clarified the relationship between the IDR/Keyframe video-encoder setting and latency in some EventBridge events. This affects two documents:

March 25, 2021

Monitoring Amazon IVS with Amazon CloudWatch

Clarified how long CloudWatch retains data.

March 18, 2021

Streaming Configuration

In "Audio Settings," changed the supported bitrate to 320 Kpbs (from 192).

March 15, 2021

Required versions of TLS

Clarified requirements for TLS (Transport Layer Security). For API calls, clients must support TLS 1.0 or later, but we recommend TLS 1.2 or later. For streaming/playback, TLS version 1.2 or later is required.

Changes were made in two documents: Streaming Configuration (section on "Stream Ingest: Codecs, RTMPS, and Port 443") and Security (section on "Infrastructure Security").

March 15, 2021

Amazon IVS Player: SDK for Web Guide

Added a known issue with HTML5 and setQuality().

March 15, 2021

Amazon IVS Player: SDK for Web Guide

Added a known issue with captions.

March 11, 2021

Amazon IVS Player

Added sections on "Thread Safety" in SDK for Android Guide and SDK for IOS Guide.

Also, for Android, noted that after the player.release() method is called, the player can no longer be used.

March 2, 2021

Monitoring Amazon IVS with Amazon CloudWatch

Updated the procedure for accessing Amazon IVS metrics using the CloudWatch console: added information on when "IVS" is listed and a screenshot.

February 26, 2021

Security

In “Infrastructure Security,” added a note that Amazon IVS streaming requires TLS 1.2. Also listed a new web page for details on AWS global network security procedures.

February 17, 2021

Amazon IVS Player: JW Player Integration

New User Guide page on the JW Player plug-in for the Amazon IVS player. Also added a JW Player row to the Framework Integrations table in the Web Player Guide.

January 28, 2021

Using Amazon EventBridge with Amazon IVS

Expanded the wording about guarantees for sending events.

January 22, 2021

Using Amazon EventBridge with Amazon IVS

Added: Events are sent on a best-effort basis.

January 13, 2021

Streaming Configuration

Changed the codec audio setting from AAC to AAC (LC).

December 18, 2020

Amazon IVS Service Quotas

In "Resource Quotas," added the maximum number of tags for a resource.

December 17, 2020

Android Player 1.2.1 release

Bug-fix release; see Amazon IVS Release Notes. Also updated version-number references in links and text in the Android Player Guide.

December 16, 2020

Amazon IVS Release Notes

For Amazon IVS Android Player 1.2.0 and 1.1.0, added a known issue which causes the SDK to crash.

December 11, 2020

Getting Started with Amazon IVS

In bullet on playback URLs (in "Step 3: Create a Channel"), added a note that custom domains for playback are not supported.

December 4, 2020

Amazon IVS Release Notes

Deleted download links for iOS Player 1.0.6 and 1.0.0; these versions are deprecated.

Added a "Known Issue" for iOS Player 1.2.0.

December 4, 2020

Player 1.2.0 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, and Video.js Integration. Added a Known Issue to the Android guide.

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

Also see the updated Amazon IVS Release Notes.

November 23, 2020

Setting Up Private Channels

In the section on "Generate and Sign Playback Tokens," the channel-arn value in the JWT payload is a string.

November 18, 2020

Using Amazon EventBridge with Amazon IVS

Added stream_id field to many events. This is a unique stream identifier assigned each time a channel goes live. For a given channel, each live stream has a new stream_id. Stream IDs allow customers to distinguish different stream sessions on the same channel.

November 12, 2020

Embedding Metadata Within a Video Stream

Added new section on "Viewing Timed Metadata" from the Amazon IVS console.

November 9, 2020

Web Player Guide

Updated the section on "Content Security Policy," especially for hosting assets on a separate page when using Safari.

November 4, 2020

Service Quotas (CCV and CCB limits)

Added notes about the importance of ensuring adequate concurrent-viewer and concurrent-broadcaster limits, especially before large streaming events. See Getting Started with Amazon IVS and Amazon IVS Service Quotas.

November 4, 2020

Using Amazon EventBridge with Amazon IVS

Updated Limit Breach events: the detail section of the JSON blob uses limit_name for all these events. (Previously only Concurrent Broadcasts showed that and the others showed limit.)

October 28, 2020

Setting Up Private Channels

In the section on "Generate and Sign Playback Tokens,"noted that the exp (expiration) field in JWT payloads is an integer.

October 27, 2020

Amazon IVS Service Quotas

Increased three limits: number of channels, concurrent viewers, and concurrent broadcasts.

October 27, 2020

Web Player 1.1.2 release

Bug-fix release; see the Amazon IVS Release Notes. Version-number references in links and text were updated in the Web Player Guide and Video.js integration Guide.

October 9, 2020

Ingest resolution quotas & event

Added service quotas and EventBridge events for ingest resolution. See Amazon IVS Service Quotas and Using Amazon EventBridge with Amazon IVS.

October 9, 2020

Player 1.1.0 release

Updated version number and artifact links for the new release, in all player guides: Web, Android, iOS, and Video.js Integration.

In the iOS and Web guides, added a new section on "Known Issues."

On the Amazon IVS documentation landing page, updated the player SDK Reference links to point to the new versions.

In the Amazon IVS Player overview, deleted the Android getSessionId function (which does not yet work).

October 7, 2020

Setting Up Private Channels

Added a new section, "Workflow for Private Channels." In the section on generating and signing tokens, clarified payload field descriptions and example. Corrected examples for listing and getting playback key pairs.

September 21, 2020

Using Amazon EventBridge with Amazon IVS

The channel_name field was added to several events.

September 14, 2020

Embedding Metadata Within a Video Stream

Expanded information on setting up IAM permissions (full procedure and policy), inserting metadata (added a CLI procedure), and consuming metadata (linked to several GitHub demos).

September 14, 2020

Player guides

Clarified which is the most current version of each player (Web, Android, iOS, and Video.js Integration).

September 9, 2020

Getting Started with Amazon IVS

Mentioned that there is a short delay before a new stream can be viewed in the console.

September 9, 2020

Amazon IVS Release Notes

Changed the Player iOS download link to be the same as what is in the Player iOS Guide.

September 9, 2020

Embedding Metadata within a Video Stream

Added link to relevant AWS blog posts.

September 3, 2020

Amazon IVS Player

Expanded the discussion of player features. Clarified that we can guarantee the performance of only the Amazon IVS player (not third-party players).

September 3, 2020

Amazon IVS Service Quotas

Corrected this to indicate that only the channels, concurrent viewers, and concurrent broadcasts quotas can be adjusted.

August 31, 2020

Streaming Configuration

Several changes, including adding Reducing Latency subsection on “Avoid Third-Party Streaming/Forwarding Services” and clarifying why we strongly recommend CBR over VBR.

August 24, 2020

Embedding Metadata within a Video Stream

Updated Web example in Consuming Timed Metadata.

August 24, 2020

Amazon IVS Player: SDK for Android Guide

Updated code example in Install the Library.

August 24, 2020

Using Amazon EventBridge with Amazon IVS

In the section on “Examples: Limit Breach,” updated several field names: limit_name, limit_value, exceeded_by, and limit_unit. These names include underscores (not dashes).

August 19, 2020

Setting Up Private Channels

New User Guide page on new Amazon IVS functionality, supporting private channels. This also affects several existing documents:

Getting Started with Amazon IVS and Logging Amazon IVS API Calls with AWS CloudTrail: Added authorized field to channel.

Security: Several changes including a new section on “Privileged and Unprivileged Access.”

Service Quotas: Added several playback quotas.

Glossary: Added playback key pair.

August 19, 2020

Getting Started with Amazon IVS

Added a new section on AWS Regional Service.

August 11, 2020

Amazon IVS Player: SDK for iOS Guide

Updated links to the reference documentation and framework download to point to the 1.0.6 release. Also updated reference-doc link on the Amazon IVS doc landing page.

August 11, 2020

Using Amazon EventBridge with Amazon IVS

Amazon IVS EventBridge events are now available through the Amazon EventBridge console. See the section on "Creating Amazon EventBridge Rules for Amazon IVS."

August 5, 2020

Amazon IVS Player: Video.js Integration

In the “Setup With NPM” section, updated the link to the Video.js npm package to install, to version 7.6.6.

July 30, 2020

Using Amazon EventBridge with Amazon IVS

For Amazon IVS stream-state and stream-health changes, the event name is provided in a field called event_name (not eventName, as previously documented).

July 29, 2020

Getting Started with Amazon IVS

Changed the instructions for setting up streaming software, to indicate that port 443 is required for Amazon IVS ingest. This also affects the Streaming Configuration document; see the new section on RTMPS and Port 443.

July 27, 2020

Amazon IVS Player: SDK for iOS Guide

Changed the download location of the latest version, in the instructions for installing the framework manually.

July 27, 2020

Embedding Metadata Within a Video Stream

Added Android and iOS examples of consuming timed metadata.

July 24, 2020

New service and User Guide

This is the initial release of Amazon Interactive Video Service (IVS).

July 15, 2020

IVS API Reference Changes

API Change Description Date

Timestamp fields

For ISO 8601 fields, added a note that these are returned as strings. Due to an auto-generation issue, these appear in our documented syntax as number.

March 28, 2022

API authorization

In "Authentication versus Authorization," clarify the bullet on authorization.

March 18, 2022

ARN encoding in tag endpoints

For the three tag endpoints, added a statement that the resourceArn field must be URL-encoded.

March 18, 2022

Audio/video configuration objects

Updated the definitions of the AudioConfiguration and VideoConfiguration data types, to indicate that they are used for monitoring. (Configuration is done in the broadcaster’s encoder.)

February 17, 2022

R2S3 thumbnail configuration release

Added a new field (thumbnailConfiguration) in the RecordingConfiguration object. This in turn affects the CreateRecordingConfiguration request and response, GetRecordingConfiguration response, and GetStreamSession response.

Added a new object: ThumbnailConfiguration.

January 18, 2022

Stream Health release

Added 2 endpoints: GetStreamSession and ListStreamSessions.

Added 7 objects: AudioConfiguration, IngestConfiguration, StreamEvent, StreamFilters, StreamSession, StreamSessionSummary, and VideoConfiguration.

Added the streamID field to the Stream and StreamSummary objects. This in turn affects the GetStream and ListStreams responses.

Added the filtersBy field to the ListStreams request.

November 18, 2021

Format of time fields

Updated the description of startTime in the Stream and StreamSummary objects, to add that it’s an ISO 8601 timestamp returned as a string.

September 21, 2021

STANDARD channel type

For the STANDARD channel type, added notes that audio is transcoded only for renditions 360p and below; above that, audio is passed through.

August 18, 2021

ListTagsForResource endpoint

Removed support for pagination; i.e., the maxResults request field and nextToken request/response field. (Pagination did not work correctly.)

August 13, 2021

PutMetadata TPS limit per account

For the PutMetadata endpoint, added a limit of 155 TPS per account.

June 29, 2021

Channel-type definitions

Updated the definitions of channel types. For STANDARD channels, resolution can be up to 1080p; for BASIC channels, 480p. (The prior definitions were only in terms of vertical resolution.)

June 17, 2021

Supported regions and service endpoints

Replace lists of supported regions with a link to the Amazon IVS page in the AWS General Reference, which is updated automatically when support for new regions is added. Changes were made on the "Welcome" page.

June 8, 2021

Tagging

In "Tagging" (in the "Welcome" section), added the maximum number of tags that can be applied to a resource (50).

May 12, 2021

New CloudWatch Metrics

Changed the definition of viewerCount in the Stream and StreamSummary objects.

April 13, 2021

Auto-Record to S3

  • Added 4 recording-configuration endpoints (Create, Delete, Get, List).

  • Add 4 data types (DestinationConfiguration, RecordingConfiguration, RecordingConfigurationSummary, S3DestinationConfiguration).

  • Added a RecordingConfigurationArn field to the Channel and ChannelSummary objects and channel endpoints.

  • Modified ListChannels to filter by recording-configuration ARN.

April 7, 2021

Authentication & authorization

  • Added an “Authentication versus Authorization” section to clarify the difference between these concepts.

  • Changed the description of the authorized field (in the Channel data type and channel endpoints), to: "Whether the channel is private (enabled for playback authorization)."

March 16, 2021

PutMetadata

Added a minimum length (1) for the metadata request field.

March 4, 2021

Channel latency mode

In Create/UpdateChannel and Channel/ChannelSummary objects, added a description of latencyMode values.

December 18, 2020

Channel default values

  • In Channel data type, add default value for authorized.

  • In Channel data type and CreateChannel, add default value for type.

December 17, 2020

All List endpoints

Indicated that the maxResults request field has a default value, 50.

December 5, 2020

Stream & StreamSummary objects

Changed the description of the viewerCount field to indicate that a value of -1 indicates that the request timed out; in this case, retry.

November 10, 2020

Authentication

Added Sigv4 signing info. See "Authentication" in the Welcome section.

October 9, 2020

DeleteChannel & DeleteStreamKey

Changed the HTTP response from 200 to 204. August 26, 2020
DeleteChannel Clarified how to delete a channel that’s live, to avoid an error. August 20, 2020
Playback authorization (for private channels)
  • New PlaybackKeyPair endpoints

  • A new authorized field in the Channel and ChannelSummary objects

  • New objects, PlaybackKeyPair and PlaybackKeyPairSummary

August 19, 2020
New service and API Reference This is the initial release of Amazon Interactive Video Service (IVS). July 15, 2020

IVS Chat API Documentation Changes

API Change Description Date

New functionality

This is the initial release of Amazon IVS Chat. We added an Amazon IVS Chat section of the documentation landing page, with two API reference documents:

April 26, 2022