# ステップ 4: IVS Broadcast SDK を統合する
<a name="getting-started-broadcast-sdk"></a>

IVS には、アプリケーションに統合できるウェブ、Android、iOS 用のブロードキャスト SDK が用意されています。ブロードキャストSDKは、ビデオの送信と受信の両方に使用されます。[ステージ に RTMP 取り込みを設定](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html)している場合は、RTMP エンドポイント (OBS や ffmpeg など) にブロードキャストできる任意のエンコーダを使用できます。

このセクションでは、2 人以上の参加者がリアルタイムで対話できるようにする簡単なアプリケーションを作成します。以下の手順では、BasicRealTime というアプリを作成する手順を説明します。アプリの全コードは CodePen と GitHub にあります。
+  Web: [https://codepen.io/amazon-ivs/pen/ZEqgrpo](https://codepen.io/amazon-ivs/pen/ZEqgrpo) 
+  Android: [https://github.com/aws-samples/amazon-ivs-real-time-streaming-android-samples](https://github.com/aws-samples/amazon-ivs-real-time-streaming-android-samples) 
+  iOS: [https://github.com/aws-samples/amazon-ivs-real-time-streaming-ios-samples](https://github.com/aws-samples/amazon-ivs-real-time-streaming-ios-samples) 

## Web
<a name="getting-started-broadcast-sdk-web"></a>

### ファイルのセットアップ
<a name="getting-started-broadcast-sdk-web-setup"></a>

最初に、フォルダと最初の HTML および JS ファイルを作成してファイルを設定します。

```
mkdir realtime-web-example
cd realtime-web-example
touch index.html
touch app.js
```

ブロードキャスト SDK は、スクリプトタグまたは npm を使用してインストールできます。この例では、わかりやすくするためにスクリプトタグを使用していますが、後で npm を使用する場合でも簡単に変更できます。

### スクリプトタグを使用する
<a name="getting-started-broadcast-sdk-web-script"></a>

Web Broadcast SDK は JavaScript ライブラリとして分散されており、[https://web-broadcast.live-video.net/1.33.0/amazon-ivs-web-broadcast.js](https://web-broadcast.live-video.net/1.33.0/amazon-ivs-web-broadcast.js) で入手できます。

`<script>` タグを使用してロードすると、ライブラリは `IVSBroadcastClient` という名前のウィンドウスコープにグローバル変数を公開します。

### npmを使う
<a name="getting-started-broadcast-sdk-web-npm"></a>

npm パッケージをインストールします。

```
npm install amazon-ivs-web-broadcast
```

これで IVSBroadcastClient オブジェクトにアクセスできるようになりました。

```
const { Stage } = IVSBroadcastClient;
```

## Android
<a name="getting-started-broadcast-sdk-android"></a>

### Android プロジェクトの作成
<a name="getting-started-broadcast-sdk-android-project"></a>

1. Android Studio で **[新規プロジェクト]** を作成します。

1. **[空のビューアクティビティ]** を選択します。

   注: Android Studio の一部の古いバージョンでは、ビューベースのアクティビティが **[空のアクティビティ]** になっていることがあります。お使いの Android Studio ウィンドウに **[空のアクティビティ]** と表示されており、**[空のビュー]** アクティビティが*表示されない*場合は、**[空のアクティビティ]** を選択してください。それ以外の場合は **[空のアクティビティ]** を選択しないでください。View API (Jetpack Compose ではなく) を使います。

1. プロジェクトに **[名前]** を付けて、**[終了]** を選択します。

### ブロードキャスト SDK のインストール
<a name="getting-started-broadcast-sdk-android-install"></a>

Amazon IVS Android Broadcast ライブラリを Android 開発環境に追加するには、ここに説明されているように、ライブラリをモジュールの `build.gradle` ファイル (最新バージョンの Amazon IVS Broadcast SDK) に追加します。新しいプロジェクトの場合、`mavenCentral` リポジトリがすでに `settings.gradle` ファイルに含まれている場合があります。その場合は、`repositories` ブロックを省略することができます。このサンプルでは、`android` ブロック内でデータバインディングも有効にする必要があります。

```
android {
    dataBinding.enabled true
}

repositories {
    mavenCentral()
}
 
dependencies {
     implementation 'com.amazonaws:ivs-broadcast:1.40.0:stages@aar'
}
```

または、SDK を手動でインストールするには、次の場所から最新バージョンをダウンロードします。

[https://search.maven.org/artifact/com.amazonaws/ivs-broadcast](https://search.maven.org/artifact/com.amazonaws/ivs-broadcast)

## iOS
<a name="getting-started-broadcast-sdk-ios"></a>

### iOS プロジェクトの作成
<a name="getting-started-broadcast-sdk-ios-project"></a>

1. 新しい Xcode プロジェクトを作成します。

1. **[プラットフォーム]** で **iOS** を選択します。

1. **[アプリケーション]** では **[アプリ]** を選択します。

1. アプリの **[製品名]** を入力し、**[次へ]** を選択します。

1. プロジェクトを保存するディレクトリを選択 (移動) し、**[作成]** を選択します。

次に、SDK を導入する必要があります。手順については、「*iOS Broadcast SDK Guide*」の「[ライブラリのインストール](broadcast-ios-getting-started.md#broadcast-ios-install)」を参照してください。

### アクセス許可の設定
<a name="getting-started-broadcast-sdk-ios-config"></a>

プロジェクトの `Info.plist` を更新して、`NSCameraUsageDescription` および `NSMicrophoneUsageDescription` に 2 つの新しいエントリを追加する必要があります。値には、アプリがカメラとマイクへのアクセスを要求する理由を説明する、ユーザー向けの説明を入力します。

![\[iOS のアクセス許可を設定します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/RealTimeUserGuide/images/iOS_Configure.png)