Android WebCastのダウンロード - Android WebCastソースコードのダウンロード

Android WebCast

その他のソースコード

v05.01.00

ダウンロード

ウェブキャスト

Web サイトからビデオ (ファイル/ストリーム) URL を抽出し、他の場所 (内部/外部ビデオプレーヤー、Google Chromecast、ExoAirPlayer) で視聴するための Android アプリ。

スクリーンショット..

ウェブキャスト

ツアー

BrowserActivityアプリの起動時に表示され、次のものが含まれます。
- 非常に基本的な Web ブラウザ
  - アドレスバー
  - WebView
- アクションバーのアイコン:
  - ブックマークの切り替え
    - 永続的に保存されたブックマークのリストに現在の Web サイトの URL を追加または削除します。
- アクションバーのメニュー項目:
  - ブックマーク
    - 左側の引き出しを開く:ブックマーク
  - 動画
    - 右側の引き出しを開ける:ビデオ
  - 設定
    - SettingsActivity開く
  - 出口
    - すべての UI を閉じてアプリを終了します
- 左側の引き出し:ブックマーク
  - 以下の永続的なリストが含まれます。
    - ブックマーク切り替えアイコンを使用して保存された Web サイトの URL
    - ビデオドロワー経由で保存されたビデオ URL
  - リスト項目をクリックすると、次のことができます。
    - WebView で Web サイトの URL を開く
    - 動画のURLを見る
      - SettingsActivity実行する特定のアクションを決定します
  - リスト項目を長押しすると、次のことができます。
    - 名前を変更する
    - 消去
- 右側の引き出し:ビデオ
  - 現在WebViewにロードされている Web ページで見つかったビデオ URL の一時的なリストが含まれています
    - このリストは、 WebView新しい Web ページに移動するたびにクリアされます。
  - リスト項目をクリックすると、次のことができます。
    - 永続的に保存されたブックマークのリストにビデオ URL を追加します
    - 動画のURLを見る
      - SettingsActivity実行する特定のアクションを決定します
  - リスト項目を長押しすると、次のことができます。
    - 消去
SettingsActivity 、 BrowserActivityのアクションバーメニューから開始され、次のものが含まれます。
- ビデオプレーヤーを使用してビデオを視聴するかどうかを選択します。
  - Chromecast センダーを備えた内部
    - VideoActivityを開始します
  - 外部の
    - 暗黙的なインテントを使用してアクティビティセレクターを開始する
      - アクション
        android.intent.action.VIEW
      - データ
        動画のURL
      - タイプ
        ビデオの形式の MIME タイプ
      - エキストラ
        referUrl
        (文字列) リファラー URL
        ExoAirPlayer によって使用される
  - ExoAirPlayerの送信者
    - ExoAirPlayerSenderActivityを開始します
  - HLS プロキシ構成
    - 暗黙的なインテントを使用してアクティビティセレクターを開始する
      - アクション
        android.intent.action.VIEW
      - データ
        http://webcast-reloaded.surge.sh/proxy.html#/watch/${base64_video}/referer/${base64_referer}
      - タイプ
        「テキスト/html」
    - HlsProxyConfigurationActivityを開始します
      - 一致するインテントフィルターを持つアクティビティがない場合のみ
        標準的な Web ブラウザはこのインテントの処理を提供するはずなので、これは決して起こるべきではありません。
VideoActivity 、内部ビデオプレーヤーを使用してビデオ URL が視聴されるときに開始され、次のものが含まれます。
- エクソプレイヤー
  - ビデオコントロールツールバーの右下隅にアイコンを表示して、全画面モードのオン/オフを切り替えます
- Chromecast 送信者
  - LAN 上で少なくとも 1 台の Google Chromecast が検出されると、アクションバーのキャストアイコンが表示されます
  - Chromecast に接続している場合
    - 動画 URL は Chromecast で実行されている受信側アプリに伝達されます。
    - Chromecast レシーバーアプリは、埋め込み HTML5 ビデオプレーヤーにビデオ URL をロードします。
      - 動画データの転送は、Chromecast と動画 URL をホストするサーバーの間で直接行われます。
      - 転送は次のイベントの影響を受けません。
        VideoActivityが停止しました
        BrowserActivityが停止しました
        ウェブキャストアプリが終了しました
        Android デバイスの電源がオフになっている
- 動画URLのリスト
  - リスト項目をクリックすると、次のことができます。
    - 動画のURLを再生する
      - Chromecast に接続している場合:
        Chromecast で
      - さもないと：
        Android のExoPlayerで
        すべての HTTP リクエストにはリファラー URL が含まれます
ExoAirPlayerSenderActivity 、ExoAirPlayer センダーを使用してビデオ URL が視聴されるときに開始され、以下が含まれます。
- 単一の Web ページをロードするWebView
  - WebページのURLはAndroidのバージョンによって異なります
    - Android 5.0以降
      - ES6+ 最新の JavaScript を使用したバージョン
    - Android 4.x以降
      - ES5準拠のJavaScriptを使用したバージョン
  - URL ハッシュには次のものが含まれます。
    - #/watch/${base64_video}/referer/${base64_referer}
- Web ページは URL ハッシュからデータを読み取り、フィールドに事前入力します。
  - 動画のURL
  - リファラーURL
- Web ページは Cookie からデータを読み取り、フィールドに事前入力します。
  - ホスト
  - ポート
  - https
- ネットワーク経由でアクセス可能なExoAirPlayer受信機アプリを制御するための基本的なUIを提供します
HlsProxyConfigurationActivity使用可能な Web ブラウザーがないデバイスで HLS-Proxy 構成を使用してビデオ URL が視聴されるときに開始され、次のものが含まれます。
- ES5 準拠の Web ページをロードするWebView
  - URL ハッシュには次のものが含まれます。
    - #/watch/${base64_video}/referer/${base64_referer}
- Web ページは URL ハッシュからデータを読み取り、フィールドに事前入力します。
  - 動画のURL
  - リファラーURL
- Web ページは Cookie からデータを読み取り、フィールドに事前入力します。
  - ホスト
  - ポート
  - https
- [プレーヤーのロード]ボタンをクリックすると、次のタスクが実行されます。
  - HLS-Proxy 経由で HLS マニフェストをリダイレクトする新しいビデオ URL を構成します
  - WebView 、プロキシされた HLS マニフェストのオプションのエンドポイント宛先を提供する別の ES5 準拠 Web ページにリダイレクトします。
    - ExoAirPlayer 送信者の ES6 Web ページ
    - Chromecast 送信者の ES5 ウェブページ
      - Android 4.x 以前のWebViewの場合:
        ビデオプレーヤー機能が動作しない
      - Android 5.0 以降のWebViewの場合:
        ビデオプレーヤー機能は動作します
        Chromecast の送信機能が動作しない

重要な注意事項

一部のビデオ URL は WebCast や ExoAirPlayer では再生できますが、Chromecast やその他の外部ビデオプレーヤーでは再生できません。
- これは、一般的な戦略であるReferer HTTP リクエストヘッダーを使用してアクセスを制限するサーバーによってビデオ URL がホストされている場合に発生する可能性があります。
  - WebCast と ExoAirPlayer には、固有のビデオ URL ごとにこのヘッダーの値を構成する機能があります。
  - Chromecast レシーバーアプリは、標準のブラウザセキュリティポリシーによって制限されているため、このヘッダーの値を変更できません。
    - XHR とフェッチの仕様では、 Referer含む特定の HTTP リクエストヘッダーの変更が禁止されています
    - WebCast Chromecast レシーバーアプリ
      - このヘッダーの値を変更しようとします
      - リモートデバッガコンソールで、この試行によって警告が発生することがわかります。
        安全でないヘッダー「リファラー」の設定を拒否しました
  - 他の外部ビデオプレーヤーでは次のことが必要になります。
    - 開始インテント内の追加のreferUrlを読み取ります
    - このヘッダーの値を変更するように HTTP クライアントライブラリを設定します。
  - HLS-Proxy は便利な汎用の回避策を提供します
    - WebCast との統合のためのセットアップ:
      1. HLSプロキシをインストールする
        npm install --global "@warren-bank/hls-proxy"
      2. WebMonkeyをインストールする
        HLS-Proxy 構成を開くアプリ
      3. WebMonkeyで
        WebCast-Reloaded ユーザースクリプトをインストールする
        HLS-Proxy 構成を提供する拡張機能を ES5 準拠の Web ページに追加します
        「Start App」というラベルの付いたボタンを有効にします
        クリックすると:
        暗黙的なインテントを使用してアクティビティセレクターを開始する
        アクション
        android.intent.action.VIEW
        データ
        プロキシされた HLS マニフェスト URL
        タイプ
        「アプリケーション/x-mpegurl」
      4. ウェブキャストで
        [設定] > [ビデオプレーヤー] > [HLS プロキシ構成]
    - 使用法：
      1. HLSプロキシを実行する
        hlsd --port 8080 --req-insecure --useragent "Chrome/90"
      2. ウェブキャストで
        内部WebView目的の HLS ビデオストリームのあるページに移動します
        ビデオドロワー (右側) を開きます
        目的の HLS ビデオストリームの URL をクリックします。
        クリック:見る
        アクティビティの選択が開始されます
        WebMonkey は、一致するアクティビティを含むアプリのリストに含まれます。
        クリック： WebMonkey
      3. WebMonkeyで
        HLS-Proxy の実行インスタンスの場所を構成します。
        ホスト
        ポート
        https
        クリック:アプリを起動
        アクティビティの選択が開始されます
        WebCast は、一致するアクティビティを含むアプリのリストに含まれます
        クリック:ウェブキャストビデオプレーヤー
      4. ウェブキャストで
        をクリックしてくださいプロキシされた HLS ビデオストリームを Chromecast デバイスにキャストするためのChromecast 送信者アイコン
Android システムのWebViewコンポーネントは、Web ブラウザーのエクスペリエンスを完全に担当します。
- このコンポーネントには複雑な歴史があります
- 詳細には触れずに:
  - Android 5.0 未満のバージョンの場合
    - WebViewコンポーネントはファームウェアに組み込まれています
      - 更新できません
      - JavaScript 言語 (ES6 以降) と HTML 仕様 (HTML5) が大幅に変更されたため、最新の Web ページの読み込みがうまくいきません。
  - Android のバージョン >= 5.0 の場合
    - WebViewコンポーネントはスタンドアロンアプリケーションです
      - 更新できます
  - Android のバージョン >= 7.0
    - WebViewコンポーネントは、インストールして有効にすると、Google Chrome Web ブラウザのコンポーネントによって置き換えられます。
      - 更新できる

Git リポジトリの構成

古くなった枝
- 01-ファンデーション
  - 実験的な機能を開発およびテストするための小さなアプリのコレクション
- 02-ウェブキャスト-httpクライアント
  - 外部 HTTP クライアントライブラリを使用しました: Apache HttpClient
  - Content-Type応答ヘッダーを使用してビデオファイルを検出しました
- 03-ウェブキャスト-okhttp
  - 外部 HTTP クライアントライブラリを使用しました: okhttp
  - Content-Type応答ヘッダーを使用してビデオファイルを検出しました
- 04-ウェブキャスト-ファイル名
  - WebView使用してすべての HTTP リクエストをダウンロードします
  - 正規表現を使用して、URL リクエスト内のビデオ形式に関連付けられたファイル拡張子を検出します
アクティブなブランチ
- 05-ウェブキャスト-ファイル名-メディア3
  - WebView使用してすべての HTTP リクエストをダウンロードします
  - 正規表現を使用して、URL リクエスト内のビデオ形式に関連付けられたファイル拡張子を検出します
  - 04-webcast-filename ブランチに基づいて構築され、ExoPlayer から AndroidX Media3 に移行します。
- 00-クロームキャストレシーバーアプリ
  - WebCast Chromecast レシーバーアプリ
- gh ページ
  - WebCast Chromecast レシーバーアプリ
    - このブランチのHEAD は、常に 00-chromecast-receiver-app ブランチのHEADを参照/エイリアスする必要があります。
  - GitHub ページによってホストされています

ソースコードのハイライト

アウトバウンドHTTPリクエスト内のビデオURLの識別
- BrowserWebViewClient
  - ビデオファイルを検出するための正規表現
Web ブラウザ拡張機能によって実装されるのと同じ方法論
- 「WebCast-Reloaded」Chromium 拡張機能
  - ビデオファイルを検出するための正規表現