YouTubeへのライブ配信機能をリリースするまで

昨今、様々なプラットフォームに向けてライブ配信を行う機能が様々なモバイルアプリからの提供され万人がそれを利用しています。
このセッションではYouTubeを対象にAndroidアプリからのライブ配信を実現しリリースするまでの方法をお話させて頂きます。

具体的には、
・YouTube Data APIを利用したYouTubeへのライブ配信機能の実装方法
・YouTubeへのライブ配信機能を実際にリリースなどするにあたって必要となるGoogleの審査などについての対応方法
など2023年の現時点でAndroidアプリでライブ配信機能を実現するにあたって対応が必要な情報・フローをまるっと全てお話させていただきます。

キーワード
- YouTube Data API
- Google OAuth2.0
- RTMP(s)
- Multi channel
- Google Verification

Transcript

1. YouTubeへ 　ライブ配信機能を 　　リリースするまで yurihondo @U-NEXT
2. yurihondo Software Engineer@U-NEXT X: yurihondo @yuyuyuyuyuri 家を買う 契約をした
3. YouTubeへ ライブ配信機能を作るにあたって必要 な対応を調査・整理する が大変でした 特にリリースにあたって 対応に 苦労した でナレッジを共有します Motivation
4. • YouTubeへ ライブ配信機能をAndroidアプリで 実現する方法 • 上記機能をもつアプリをリリースするにあたって、 対処が必要な事柄へ 対応方法 Topics to be Covered
5. • YouTube以外へ ライブ配信 実現方法 • YouTube系APIや利用しているLib 詳細 • アプリ自体 品質担保やテスト手法 • Androidアプリ以外 実装に関する詳細 Topics NOT to be Covered
6. こ セッションで話す事柄 、2023/8/31時点 情報 に基づいて構成されています Note
7. 1. YouTube Streaming APIを使って配信機能を実 現する 2. APIを使うためにGoogle OAuth2.0を利用する 3. こ 機能をプロダクション環境で利用するにあ たって Google 審査を受ける必要がある TL;DR
8. Agenda 0. Roadmap for release 1. Prepare to use YouTube API 2. Realize streaming feature 3. Pass Google verification
9. Roadmap For Release 0
10. Goal Hello, World! アプリから YouTubeへ ライブ配信機能をリ リースすること
11. Google Auth Server Hello, World! Roadmap for release
12. Google Auth Server Send Request Obtain Token ①YouTube APIを使うため Tokenを取得 Roadmap for release
13. Google Auth Server Create live with Token ＆ Send streaming data Hello, World! ②APIを使ってライブ配信を実現 Roadmap for release
14. Google Auth Server Hello, World! ③リリースする時にGoogle 審査に合格 Roadmap for release
15. Roadmap for release 1 2 3 Prepare to use YouTube API Realize streaming feature Pass Google Verification
16. Simple Streaming App
17. Simple Streaming App App Web (YouTube) > https://www.youtube.com/
18. Prepare to use YouTube API 1
19. まず最初に
20. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube
21. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube/v3 メインとなるAPI、 コンテンツ 検索など YouTube 基本的な機能をほぼ全部を提供
22. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube/v3/live/getting-started YouTubeライブ配信に関わる機能 提供 内部的にData APIを利用 今回利用するAPI
23. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube 埋め込み YouTubeプレイヤーを提供
24. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube/reporting チャンネルなど 分析関連 API (使ったこと ない)
25. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube GCP上で有効化すると 利用できるようになる
26. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube 無料で利用可能
27. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube ただし😲
28. - YouTube Data API - YouTube Streaming API - IFrame Player API - YouTube Analytics API - YouTube Reporting API YouTube APIs > https://developers.google.com/youtube/v3/determine_quota_cost API 呼び出しごとにQuotaを消費する
29. Quota > https://developers.google.com/youtube/v3/determine_quota_cost • YouTube Data APIを呼ぶ毎に消費 される • 初期 10,000[unit/day]付与されて いる • 引き上げ申請可能
30. Quota > https://developers.google.com/youtube/v3/getting-started#calculating-quota-usage method action quota list Retrieves (GET) a list of zero or more resources. 1 insert Creates (POST) a new resource. 50 update Modifies (PUT) an existing resource to reflect data in your request. 50 delete Removes (DELETE) a specific resource. 50 基本 、読み取り系 1、書き込み系 50。イレギュラーで、 searchリソース list 100、videoリソース insert 1600などな ど Resource +
31. Quota > https://developers.google.com/youtube/v3/determine_quota_cost
32. Quota > https://developers.google.com/youtube/v3/determine_quota_cost リファレンスも全メソッドについて網羅されて いない 正確な消費量 GCP コンソールから確 認する がベター TIPS
33. 1. Setup GCP GCP上でYouTube APIを利用可 能にする 2. Get Token AppでOAuthを行い、APIを利用 するため Tokenを取得/保存 1 Prepare to use YouTube API Roadmap
34. 1. Setup GCP GCP上でYouTube APIを利用可 能にする 2. Get Token AppでOAuthを行い、APIを利用 するため Tokenを取得/保存 1 Prepare to use YouTube API Roadmap
35. Enable API on GCP GCP アカウントとプロジェクト 作成 方法 割愛😎
36. Enable API on GCP YouTube APIを有効化
37. Enable API on GCP OAuth clientを作成
38. Enable API on GCP
39. Enable API on GCP APIを利用するにあたって 必要になるスコープを設定する
40. Enable API on GCP ./auth/youtubeを手動追加
41. Enable API on GCP こんな感じに表示されれ 👌
42. Enable API on GCP
43. Enable API on GCP こんな感じに表示されれ 👌
44. Enable API on GCP API Keyで 今回 ユースケース 対応できない TIPS
45. Enable API on GCP GCP 設定 これでOK👌
46. 1. Setup GCP GCP上でYouTube APIを利用可 能にする 2. Get Token AppでOAuthを行い、APIを利用 するため Tokenを取得/保存 1 Prepare to use YouTube API Roadmap
47. Simple Streaming App Google Auth Server Send Request Obtain Token
48. OAuth 2.0 for Google APIs > https://developers.google.com/identity/protocols/oauth2/native-app
49. Get Access Token AppAuth for Androidを使う > https://developers.google.com/identity/protocols/oauth2/native-app
50. Reasons for adopting AppAuth 1. ブラウザベース 認証フローを提供している 2. Google以外 認証が増えた場合なども 柔軟に対応可能 3. Google Play開発者サービスに依存しない TIPS
51. Reasons for adopting AppAuth 1. ブラウザベース 認証フローを提供している 2. Google以外 認証が増えた場合なども 柔軟に対応可能 3. Google Play開発者サービスに依存しない ブラウザ(Custom Tabs)で OAuthフローを提供する で、 セキュリティ面やユーザー体験 面で良い TIPS
52. Get Access Token 認証時に ブランドアカウントを 選択可能 TIPS
53. 1. ブラウザベース 認証フローを提供している 2. Google以外 認証が増えた場合なども 柔軟に対応可能 3. Google Play開発者サービスに依存しない Get Access Token YouTube以外 配信先ができて、 新しい認証を行う場合でも流用できる TIPS
54. 1. ブラウザベース 認証フローを提供している 2. Google以外 認証が増えた場合なども 柔軟に対応可能 3. Google Play開発者サービスに依存しない Get Access Token 地域やデバイス事情に対応 TIPS
55. Google Auth Server Get Access Token Browser Repository Activity Encrypted DataStore AppAuth App
56. Google Auth Server Get Access Token Browser Repository Activity Encrypted DataStore AppAuth Auth request App
57. Google Auth Server Get Access Token Browser Repository Activity Encrypted DataStore AppAuth Authorize Login App
58. Google Auth Server Get Access Token Browser Repository Activity Encrypted DataStore AppAuth Redirect with Auth Code App
59. Google Auth Server Get Access Token Repository Activity Encrypted DataStore AppAuth Pass Auth Code Save encrypted Auth Code App
60. Google Auth Server Get Access Token Repository Activity Encrypted DataStore AppAuth Exchange code Token App Save encrypted Token
61. 詳しい実装 こちら https://github.com/yurihondo/simplestreaming/blob/main /core/data/src/main/java/com/yurihondo/simplestreaming /data/repository/AccountRepositoryImpl.kt
62. Google Auth Server Get Access Token Browser Repository Activity Encrypted DataStore AppAuth Authorize Login
63. Get Access Token
64. Get Access Token 認証情報を消せ 再度ログインフローを試せる TIPS
65. Google Auth Server Get Access Token Browser Repository Activity Encrypted DataStore AppAuth Save encrypted Auth State
66. Get Access Token CryptoHelper 暗号化 Tinkを利用 TIPS
67. Get Access Token EncryptedAuthStateSerializer TIPS
68. Get Access Token DataStoreModule TIPS
69. Google Auth Server Get Access Token Repository Activity Encrypted DataStore AppAuth Exchange code Token App Save encrypted Token
70. Enable API on GCP AccountRepository　
71. Enable API on GCP AccountRepository Refresh 処理を忘れないこと TIPS
72. Enable API on GCP AccountRepository　 TIPS
73. Google Auth Server Hello, World! Get Access Token APIを使うため 準備 完了
74. Feature Complete
75. Realize Streaming feature 2
76. Simple Streaming App Google Auth Server Create live with Token ＆ Send streaming data Hello, World!
77. 2 Realize streaming feature 1. Create Live YouTube Live Streaming APIを使っ て、Live streamを作成 2. Stream using RTMPS 配信データをRTMPSで送信し、 ライブ配信機能を実現 Roadmap
78. 2 Realize streaming feature 1. Create Live YouTube Live Streaming APIを使っ て、Live streamを作成 2. Stream using RTMPS 配信データをRTMPSで送信し、 ライブ配信機能を実現 Roadmap
79. Live streaming Create Live
80. Live streaming LiveStream Broadcast
81. Live streaming LiveStream Broadcast Bind
82. Create Live build.gradle.kts
83. Create Live LiveStreamingRepository　
84. Create Live LiveStreamingRepository　 先に取得したTokenを渡して YouTubeApiを初期化
85. Create Live LiveStreamingRepository　 AndroidJsonFactoryとかでもOK
86. Live streaming LiveStream Broadcast
87. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert
88. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert Broadcast 作成リクエスト
89. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert 設定対象 パーツを宣言 （レスポンスにも含まれる）
90. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert
91. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert
92. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert あと 実行するだけ
93. Live streaming LiveStream Broadcast
94. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveStreams/insert
95. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveStreams/insert
96. Create Live LiveStreamingRepository　 > https://developers.google.com/youtube/v3/live/docs/liveStreams/insert RTMPS 指定 ”rtmp”でOK
97. Live streaming LiveStream Broadcast Bind
98. Create Live LiveStreamingRepository　
99. Create Live LiveStreamingRepository　 Broadcast, LiveStream IDを 指定してBind実行
100. Live created Create Live
101. 2 Realize streaming feature 1. Create Live YouTube Live Streaming APIを使っ て、Live streamを作成 2. Stream using RTMPS 配信データをRTMPSで送信し、 ライブ配信機能を実現 Roadmap
102. Live streaming Stream using RTMPS Hello, World!
103. SimpleStreaming 実装 こちら https://github.com/yurihondo/simplestreaming/blob/m ain/core/data/src/main/java/com/yurihondo/simplestre aming/data/repository/LiveStreamingRepositoryImpl.kt
104. Create Stream URL LiveStreamingRepository　 配信先URLを作成
105. Create Stream URL LiveStreamingRepository　 ingestionAddressもあるが これ RTMP向けな で注意 TIPS
106. Streaming state ready testing live complete Transition APIでlive状態にする
107. Streaming state ready testing live complete
108. Streaming state ready testing live complete
109. Streaming state ready testing live complete testing スキップできない TIPS
110. Create Live LiveStreamingRepository　
111. Create Live LiveStreamingRepository　 現在 Stateを取得 LiveStreamingRepository　
112. Create Live LiveStreamingRepository　 現在 Stateに合わせ次 Stateへ変更
113. Create Live LiveStreamingRepository　 State 切り替えに結構時間がかかる 5[sec] * 12回 1[min]ほど断続的に実行 TIPS
114. Create Live LiveStreamingRepository　 TIPS データ送信し始めると 自動でlive状態にする設定 ある笑
115. Live streaming Hello, World!
116. Google Verification じゃぁ配信してみよう
117. Google Verification
118. Feature Complete ライブ配信が 有効になっているか確認 > https://www.youtube.com/ TIPS
119. Feature Complete > https://www.youtube.com/ TIPS
120. Feature Complete > https://support.google.com/youtube/answer/9228390?hl=ja&co=GENIE.Platform%3DAndroid# TIPS チャンネル登録者数 制限 ない (0人でもライブ配信 可能)
121. Feature Complete
122. Pass Google Verification 3
123. 3 Pass Google Verification • Google Verification Google OAuth2.0を利用した Token 取得を一般公開する アプリでも使えるように、 Googleが定める審査に合格す る Roadmap
124. Google Verification 機能 実現できている なぜ審査が必要な か🤔
125. Google Verification Authに テスト環境と本番環境 設定がある
126. Google Verification テスト環境 制限 1. 100アカウントまでしかOAuthを実行できない 2. OAuthプロセスにおけるログイン時に ”こ アプリ 未検証である”旨が表示される
127. Google Verification テスト環境 制限 1. 100アカウントまでしかOAuthを実行できない 2. OAuthプロセスにおけるログイン時に ”こ アプリ 未検証である”旨が表示される
128. Google Verification
129. Google Verification テスト環境 制限 1. 100アカウントまでしかOAuthを実行できない 2. OAuthプロセスにおけるログイン時に ”こ アプリ 未検証である”旨が表示される
130. Google Verification
131. Google Verification GCPコンソールで OAuth 設定を本番環境に切り替える
132. Scope categories > https://developers.google.com/identity/protocols/oauth2/production-readiness/policy-compliance#sensitive-restricted-scope-verification non-sensitive以外 スコープを利用する場合、 本番切り替え時に審査が必要 non-sensitive sensitive restricted Needs verification Needs verification
133. Google Verification > https://developers.google.com/identity/protocols/oauth2/production-readiness/policy-compliance#sensitive-restricted-scope-verification ./auth/youtube 、sensitiveスコープな で 本番環境に切り替えた時に審査開始する
134. Google Verification > https://developers.google.com/identity/protocols/oauth2/production-readiness/policy-compliance#sensitive-restricted-scope-verification 担当チームからメールが届き、 必要に応じてGoogle 規約に準拠するため 対応を行う The Google Trust & Safety Security & Privacy Team
135. Google Verification > https://developers.google.com/identity/protocols/oauth2/production-readiness/policy-compliance#sensitive-restricted-scope-verification 担当チームからメールが届き、 必要に応じてGoogle 規約に準拠するために対応を行う The Google Trust & Safety Security & Privacy Team 審査が完了するまで テスト環境 制限が継続する
136. Google Verification > https://support.google.com/cloud/answer/9110914#how-long&zippy=%2Chow-long-will-the-verification-process-take 担当チームからメールが届き、 必要に応じてGoogle 規約に準拠するために対応を行う The Google Trust & Safety Security & Privacy Team 最近だとやりとりや対応も含めて 審査完了までに 4~6週間以上かかる...いや... TIPS
137. Google Verification > https://support.google.com/cloud/answer/9110914#how-long&zippy=%2Chow-long-will-the-verification-process-take 担当チームからメールが届き、 必要に応じてGoogle 規約に準拠するために対応を行う The Google Trust & Safety Security & Privacy Team 指摘をなるべく減らすために 事前 準備が重要 TIPS
138. Google Verification 審査通過 ために... 何をすれ 良いか🤔？
139. Google Verification ガイドラインに従って 各対応を行い、 GCP OAuthクライアント 設定に反映させる > https://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verification
140. Google Verification Privacy policy 設定 03 Webサイト 設定＆Domain証明 02 ブランドガイドライン対応 01 デモ動画作成＆アップロード 04
141. Google Verification Privacy policy 設定 03 Webサイト 設定＆Domain証明 02 ブランドガイドライン対応 01 デモ動画作成＆アップロード 04
142. Google Verification > https://developers.google.com/identity/branding-guidelines > https://developers.google.com/youtube/terms/branding-guidelines
143. Google Verification
144. Google Verification ログインボタンに YouTubeロゴを適切に配置
145. Google Verification Privacy policy 設定 03 Webサイト 設定＆Domain証明 02 ブランドガイドライン対応 01 デモ動画作成＆アップロード 04
146. Google Verification アプリ ホームページが必要 > https://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verification
147. Google Verification ドメイン所有権 証明が必要
148. Google Verification > https://yurihondo.com
149. Google Verification
150. Google Verification 認証画面 設定 へ反映
151. Google Verification Privacy policy 設定 03 Webサイト 設定＆Domain証明 02 ブランドガイドライン対応 01 デモ動画作成＆アップロード 04
152. Google Verification アプリがユーザーデータをど ように扱うかについて明示する > https://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verification
153. Google Verification
154. Google Verification • Google API serviceが定めるユーザーデータ ポリシーに準 拠するように必要に応じてアプリ データ 扱いを修正 • プライバシーポリシーへ リンク ホームページと同じドメインに 配置いること • ホームページ トップにプライバシーポリシーへ リンクがあるこ と > https://developers.google.com/terms/api-services-user-data-policy
155. Google Verification > https://developers.google.com/terms/api-services-user-data-policy
156. Google Verification > https://yurihondo.com#privacy-policy
157. Google Verification
158. Google Verification 利用規約 記載 任意だけど、 追加しておくことをおすすめする
159. Google Verification Privacy policy 設定 03 Webサイト 設定＆Domain証明 02 ブランドガイドライン対応 01 デモ動画作成＆アップロード 04
160. Google Verification アプリがAPIをど ように使用しているかを明示するビデオを作成 して、YouTubeあげURLを共有する > https://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verification
161. Google Verification • APIを呼ぶをタイミング 全てキャプションを入れる • OAuth時 ログイン画面などで言語をEnglishに選 択し直す • プラポリ URLなど 全て遷移する TIPS
162. Google Verification
163. Google Verification 🙏健闘を祈る🙏
164. 以上
165. • YouTubeへ ライブ配信機能 実装自体 そ 仕様を 知っていれ そこまで複雑で ありません、ぜひ参考にし てください • Google Verification とても時間がかかる でリリースタ イミングなど ...かなりバッファをみた方が良い • 話せなかったことが多い でまた別 機会で続きを... Conclusion
166. Thanks