Android デバイスでの YouTube ライブ配信の開始

YouTube モバイルライブのディープリンクにより、Android アプリはモバイル デバイスから直接 YouTube ライブ配信を開始できます。アプリは、Android インテント メカニズム経由でモバイル ライブ フローを開始する、ユーザーがクリックできるボタンなどのエントリ ポイントを提供する必要があります。

例

このフローでは、YouTube アプリにディープリンクするアプリのユーザー エクスペリエンスが示されています。このアプリでは、ユーザーがモバイル ライブ配信の設定画面に移動します。

1. まず、ユーザーが配信を設定し、タイトル、プライバシー モード、その他のストリーム オプションを設定します。
2. 次に、ユーザーは [サムネイル写真] 画面に移動し、ストリームのサムネイル画像を設定します。
3. 最後に、ユーザーがライブ配信を開始し、前面カメラまたは背面カメラからの映像を配信します。

デバイスの要件

YouTube ライブ配信とモバイルライブ ディープリンクを適切にサポートするには、Android デバイスが次の要件を満たしている必要があります。

• Android リリース: Marshmallow（API 23）以降
• カメラ: 30 Hz 以上で 720p を撮影できるカメラが 1 台以上
• Microphone（マイク）: 内蔵マイク
• オーディオ エンコーダ: 8 ビット PCM モノラル音声を 44.1 kHz 以上で AAC にエンコードできるハードウェア アクセラレーション オーディオ エンコーダ
• 動画エンコーダ: 720P の未加工動画を 30 Hz 以上の H.264/AVC にエンコードできるハードウェア アクセラレーションの動画エンコーダ
• YouTube アプリがインストール済みの場合: バージョン 13.02 以降

モバイルライブ配信のインテントの仕様

YouTube モバイルのライブ配信フローにリンクするには、Android アプリがインテントを起動します。インテントは、YouTube アプリでアクティビティを開始することで、ライブ配信プロセスを開始します。

インテントの形式

Mobile Live Intent は、カスタム Action 文字列を使用して、YouTube アプリ内のライブ作成アクティビティに移動します。また、YouTube モバイルアプリのパッケージ名も指定します。

• アクション: 「com.google.android.youtube.intent.action.CREATE_LIVE_STREAM」
• パッケージ: 「com.google.android.youtube」

インテント エクストラ

YouTube アプリの設定フローは、ストリーム構成を処理します。次の Intent の追加機能は、ライブ配信に関連付けられたパラメータを設定します。

ライブ配信フローを開始する

ステップ 1: サポートを確認する

クライアントはまず、YouTube アプリがデバイスにインストールされていること、および YouTube アプリのバージョンがライブ配信をサポートしていることを確認して、モバイル ライブ インテントを起動できることを確認する必要があります。次のコードサンプルは、そのための 2 つのメソッドを定義しています。

• canResolveMobileLiveIntent メソッドは、デバイスがモバイル ライブ インテントをサポートしていることを確認します。
• validateMobileLiveIntent は、if-else ステートメントのコンテキストで canResolveMobileLiveIntent メソッドを呼び出します。
  • デバイスが Intent をサポートしている場合、デバイスはライブ配信フローを開始できます。
  • デバイスが Intent をサポートしていない場合、YouTube アプリのインストールまたはアップグレードを促すメッセージが表示されることがあります。

private boolean canResolveMobileLiveIntent(Context context) {
  Intent intent = new Intent("com.google.android.youtube.intent.action.CREATE_LIVE_STREAM")
    .setPackage("com.google.android.youtube");
  PackageManager pm = context.getPackageManager();
  List resolveInfo = 
    pm.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
  return resolveInfo != null && !resolveInfo.isEmpty();
}


private void validateMobileLiveIntent(Context context) {
  if (canResolveMobileLiveIntent(context)) {
    // Launch the live stream Activity
  } else {
    // Prompt user to install or upgrade the YouTube app
  }
}

ステップ 2: ライブ ストリーム アクティビティを開始する

ライブ配信フローを開始するには、クライアント アプリが次のコードサンプルに示すように Intent を作成して起動します。

private Intent createMobileLiveIntent(Context context, String description) {
  Intent intent = new Intent("com.google.android.youtube.intent.action.CREATE_LIVE_STREAM")
      .setPackage("com.google.android.youtube");
  Uri referrer = new Uri.Builder()
      .scheme("android-app")
      .appendPath(context.getPackageName())
      .build();

  intent.putExtra(Intent.EXTRA_REFERRER, referrer);
  if (!TextUtils.isEmpty(description)) {
    intent.putExtra(Intent.EXTRA_SUBJECT, description);
  }
  return intent;
}


private void startMobileLive(Context context) {
  Intent mobileLiveIntent = createMobileLiveIntent(context, "Streaming via ...");
  startActivity(mobileLiveIntent);
}