IVS Broadcast SDK (リアルタイムストリーミング)

Amazon Interractive Video Searvice (IVS) リアルタイムストリーミングブロードキャスト SDK は、Amazon IVS を使用してアプリケーションを構築するデベロッパー向けのものです。この SDK は、Amazon IVS のアーキテクチャを活用するように設計されており、Amazon IVS と共に、継続的に改善され、新機能が提供されます。ネイティブのブロードキャスト SDK として、アプリケーションおよびユーザーがアプリケーションにアクセスするデバイスに対してパフォーマンスへの影響を最小限に抑えるように設計されています。

Broadcast SDK はビデオの送信と受信の両方に使用されることに注意してください。ホストとビューアーには同じ SDK を使用します。個別のプレーヤー SDK は必要ありません。

アプリケーションでは、Amazon IVS Broadcast SDK の主な機能を活用できます。

• 高品質ストリーミング — ブロードキャスト SDK は、高品質のストリーミングをサポートします。カメラからビデオをキャプチャし、最大 720p でエンコードします。

• 自動ビットレート調整 — スマートフォンユーザーは移動するため、ブロードキャストの過程でネットワークの状況が変わることがあります。Amazon IVS Broadcast SDK は、変化するネットワーク状況に対応するために、動画のビットレートを自動的に調整します。

• 縦向きと横向きのサポート — ユーザーがデバイスをどのように持っているかに関係なく、画像は正しい向きで適切に拡大縮小されて表示されます。Broadcast SDK は、ポートレートとランドスケープの両方のキャンバスサイズをサポートします。ユーザーが設定した向きからデバイスを回転させると、アスペクト比が自動的に調整されます。

• セキュアなストリーミング — ユーザーのブロードキャストは、 TLS を使用して暗号化されるため、ストリームを安全に保つことができます。

• 外部オーディオデバイス — Amazon IVS Broadcast SDK は、オーディオジャック、USB、および Bluetooth SCO 外部マイクをサポートしています。

プラットフォームの要件

ネイティブプラットフォーム

プラットフォーム	サポートされているバージョン
Android	9.0 以降 -- バージョン 5.0 でビルドすることはできますが、リアルタイムストリーミング機能は使用できないことに注意してください。
iOS	14 以降

IVS は、少なくとも 4 つの iOS メジャーバージョンと 6 つの Android メジャーバージョンをサポートしています。現在のサポート対象バージョンは、これらの最小値よりも多い可能性があります。メジャーバージョンがサポートされなくなる場合は、少なくとも 3 か月前に SDK リリースノートでお客様にお知らせします。

デスクトップブラウザ

ブラウザ	サポートされているプラットフォーム	サポートされているバージョン
Chrome	Windows、macOS	2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン)
Firefox	Windows、macOS	2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン)
Edge	(Windows 8.1 以降)	2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) Edge Legacy は除く
Safari	macOS	2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン)

モバイルブラウザ (iOS および Android)

ブラウザ	サポートされているプラットフォーム	サポートされているバージョン
Chrome	iOS、Android	2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン)
Firefox	Android	2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン)
Safari	iOS	2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン)

既知の制限事項

• どのモバイルデバイスでも、動画の乱れや画面の暗転の問題があるため、4 人以上の参加者が同時に公開/サブスクライブすることはお勧めしません。参加者をそれより多くする必要がある場合は、オーディオのみの公開とサブスクライブを設定します。

• パフォーマンス上の問題やクラッシュの可能性を考慮して、ステージを合成して Android Mobile Web のチャネルに配信することはお勧めしません。ブロードキャスト機能が必要な場合は、IVS リアルタイムストリーミングの Android Broadcast SDK を統合してください。

ウェブビュー

Web Broadcast SDK は、ウェブビューやウェブライク環境 (テレビ、家庭用ゲーム機など) をサポートしていません。モバイル実装については、Android 向けおよび iOS 向けの「IVS Broadcast SDK ガイド (リアルタイムストリーミング)」を参照してください。

必要なデバイスのアクセス

Broadcast SDK では、デバイス内蔵のカメラとマイクと、Bluetooth、USB、またはオーディオジャックを介して接続されているカメラとマイクにアクセスする必要があります。

サポート

ブロードキャスト SDK は継続的に改良しています。利用可能なバージョンと修正済みの問題については Amazon IVS リリースノートを参照してください。必要な場合、サポートに連絡する前にお使いのプレイヤーのバージョンを更新し、問題が解決するかどうか確認してください。

バージョニング

Amazon IVS Broadcast SDK は、セマンティックバージョニングを使用しています。

以下の解説は、次を前提としています。

• 最新リリースは 4.1.3。

• 1 つ前のメジャーバージョンの最新リリースは 3.2.4。

• バージョン 1.x の最新リリースは 1.5.6.

最新バージョンのマイナーリリースとして、下位互換性のある新機能が追加されています。この場合、次回の新機能のセットは、バージョン 4.2.0 として追加されます。

下位互換性のあるマイナーなバグ修正が、最新バージョンのパッチリリースとして追加されています。ここでは、次回のマイナーなバグ修正のセットは、バージョン 4.1.4 として追加されます。

下位互換性のあるメジャーなバグ修正は異なる方法で処理されます。これらはいくつかのバージョンに追加されています。

• 最新バージョンのパッチリリース。こちらは、バージョン 4.1.4 です。

• 1 つ前のマイナーバージョンのパッチリリース。こちらは、バージョン 3.2.5 です。

• 最新バージョン 1.x リリースのパッチリリース。こちらは、バージョン 1.5.7 です。

メジャーなバグ修正は、Amazon IVS 製品チームによって定義されています。典型的な例に、重要なセキュリティ更新のほか、お客様に必要な選別された修正があります。

注: 上記の例では、リリースされたバージョンの数字は、連番でインクリメントされています(4.1.3 → 4.1.4、など)。実際は、1 つ以上のパッチ番号が内部に残り、リリースされないままになることもあります。そのため、リリースされたバージョンは 4.1.3 から (例えば) 4.1.6 に増えることもあります。