Android WebCast下載 - Android WebCast原始碼下載

Android WebCast

其他源碼

v05.01.00

下載

網路廣播

Android 應用程式從網站提取影片（檔案/串流）URL 並在其他地方觀看（內部/外部影片播放器、Google Chromecast、ExoAirPlayer）。

截圖..

網路廣播

旅遊

BrowserActivity在應用程式啟動時顯示，包括：
- 一個非常基本的網頁瀏覽器
  - 網址
  - WebView
- 操作欄圖示：
  - 書籤切換
    - 在持久保存的書籤清單中新增/刪除目前網站 URL
- 操作欄選單項目：
  - 書籤
    - 左邊打開的抽屜：書籤
  - 影片
    - 打開右側抽屜：視頻
  - 設定
    - 開啟SettingsActivity
  - 出口
    - 關閉所有UI並退出應用程式
- 左邊抽屜：書籤
  - 包含以下持久性清單：
    - 已透過書籤切換圖示儲存的網站 URL
    - 已透過視訊抽屜保存的影片 URL
  - 點選列表項目可以：
    - 在 WebView 中開啟網站 URL
    - 觀看影片網址
      - SettingsActivity決定要執行的特定操作
  - 長按列表項可：
    - 重新命名
    - 刪除
- 右側抽屜：視頻
  - 包含在目前載入到WebView網頁上找到的影片 URL 的臨時列表
    - 每次WebView導航到新網頁時都會清除此列表
  - 點選列表項目可以：
    - 將影片 URL 新增至永久保存的書籤列表
    - 觀看影片網址
      - SettingsActivity決定要執行的特定操作
  - 長按列表項可：
    - 刪除
SettingsActivity從BrowserActivity中的操作列選單啟動，包括：
- 影片播放器選擇是否使用觀看影片。
  - 內建 Chromecast 傳送器
    - 開始VideoActivity
  - 外部的
    - 使用隱含 Intent 啟動 Activity 選擇器
      - 行動
        android.intent.action.VIEW
      - 數據
        視訊網址
      - 類型
        影片格式的 mime-type
      - 額外的
        referUrl
        （字串）引用網址
        ExoAirPlayer 使用
  - ExoAirPlayer 發送器
    - 啟動ExoAirPlayerSenderActivity
  - HLS 代理程式配置
    - 使用隱含 Intent 啟動 Activity 選擇器
      - 行動
        android.intent.action.VIEW
      - 數據
        http://webcast-reloaded.surge.sh/proxy.html#/watch/${base64_video}/referer/${base64_referer}
      - 類型
        “文字/html”
    - 啟動HlsProxyConfigurationActivity
      - 僅當沒有具有匹配 Intent 過濾器的 Activity 時
        這永遠不應該發生，因為任何標準的網頁瀏覽器都應該提供處理這個 Intent 的功能
VideoActivity在使用內部影片播放器觀看影片 URL 時啟動，包括：
- 外放播放器
  - 在視訊控制工具列的右下角顯示一個圖標，用於開啟/關閉全螢幕模式
- Chromecast 傳送器
  - 當在 LAN 上偵測到至少一個 Google Chromecast 時，顯示操作欄投射圖標
  - 連接 Chromecast 時
    - 視訊 URL 傳送到 Chromecast 中運行的接收器應用程式
    - Chromecast 接收器應用程式將影片 URL 載入到嵌入式 HTML5 影片播放器中
      - 視訊資料的傳輸直接發生在 Chromecast 和託管影片 URL 的伺服器之間
      - 下列任何事件不會影響轉讓：
        VideoActivity已停止
        BrowserActivity停止
        網路廣播應用程式已退出
        Android 裝置已關機
- 影片 URL 列表
  - 點選列表項目可以：
    - 播放影片網址
      - 如果連接到 Chromecast：
        在 Chromecast 上
      - 否則：
        在 Android 上，在ExoPlayer中
        所有 HTTP 請求都包含 Referer url
ExoAirPlayerSenderActivity在使用 ExoAirPlayer 發送器觀看影片 URL 時啟動，包括：
- 載入單一網頁的WebView
  - 網頁的 URL 取決於 Android 版本
    - Android 5.0 及更高版本
      - 使用 ES6+ 現代 javascript 的版本
    - Android 4.x 及更早版本
      - 使用 ES5 相容 javascript 的版本
  - URL 哈希包含：
    - #/watch/${base64_video}/referer/${base64_referer}
- 網頁從 URL 哈希讀取資料並預先填入欄位：
  - 視訊網址
  - 參考網址
- 網頁從 cookie 讀取資料並預先填入欄位：
  - 主持人
  - 港口
  - https
- 提供基本 UI 來控制可透過網路存取的任何 ExoAirPlayer 接收器應用程式
當在沒有任何可用 Web 瀏覽器的裝置上使用 HLS 代理程式設定觀看影片 URL 時，會啟動HlsProxyConfigurationActivity ，其中包括：
- 載入 ES5 相容網頁的WebView
  - URL 哈希包含：
    - #/watch/${base64_video}/referer/${base64_referer}
- 網頁從 URL 哈希讀取資料並預先填入欄位：
  - 視訊網址
  - 參考網址
- 網頁從 cookie 讀取資料並預先填入欄位：
  - 主持人
  - 港口
  - https
- 點擊“載入播放器”按鈕將執行以下任務：
  - 設定透過 HLS-Proxy 重定向 HLS 清單的新影片 URL
  - 將WebView重新導向到另一個符合 ES5 的網頁，該網頁為代理程式的 HLS 清單提供可選端點目標
    - ExoAirPlayer 發送器的 ES6 網頁
    - Chromecast 發送器的 ES5 網頁
      - 在 Android 4.x 及更早版本的WebView ：
        視訊播放器功能不起作用
      - 在 Android 5.0 及更高版本的WebView ：
        影片播放器功能正常
        Chromecast 發送器功能不起作用

重要警告

某些影片 URL 可以在 WebCast 和 ExoAirPlayer 中播放，但無法在 Chromecast 或其他外部影片播放器上播放
- 當影片 URL 由使用Referer HTTP 請求標頭來限制存取的伺服器託管時，可能會發生這種情況，這是一種常見策略
  - WebCast 和 ExoAirPlayer 具有為每個唯一影片 URL 配置此標頭的值的功能
  - Chromecast 接收器應用程式無法變更此標頭的值，因為它們受到標準瀏覽器安全性原則的限制
    - XHR 和 fetch 的規格禁止更改某些 HTTP 請求標頭，包括Referer
    - WebCast Chromecast 接收器應用程式
      - 嘗試變更此標頭的值
      - 在遠端偵錯器控制台中顯示此嘗試會引發警告：
        拒絕設定不安全的標頭“referer”
  - 其他外部視訊播放器需要：
    - 讀取起始 Intent 中的referUrl extra
    - 配置其 HTTP 用戶端庫以變更此標頭的值
  - HLS-Proxy 提供了一個方便的通用解決方法
    - 與 WebCast 整合的設定：
      1. 安裝 HLS 代理
        npm install --global "@warren-bank/hls-proxy"
      2. 安裝WebMonkey
        應用程式開啟 HLS-Proxy 配置
      3. 在WebMonkey中
        安裝 WebCast-Reloaded 使用者腳本
        為提供 HLS-Proxy 設定的 ES5 相容網頁新增增強功能
        啟用標記為「啟動應用程式」的按鈕
        點擊時：
        使用隱含 Intent 啟動 Activity 選擇器
        行動
        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 將包含在包含符合 Activity 的應用程式清單中
        點選：網路猴
      3. 在WebMonkey中
        配置 HLS-Proxy 運行實例的位置：
        主持人
        港口
        https
        點擊：啟動應用程式
        活動選擇器將啟動
        網路廣播將包含在包含配對活動的應用程式清單中
        點選：網路廣播視訊播放器
      4. 在網路廣播中
        點選 Chromecast 發送器圖標，用於將代理程式的 HLS 視訊串流投射到 Chromecast 設備
Android 系統WebView完全負責 Web 瀏覽器體驗
- 這個組件有一個複雜的歷史
- 無需詳細說明：
  - 在 Android < 5.0 版本上
    - WebView元件被烘焙到韌體中
      - 無法更新
      - 由於 javascript 語言 (ES6+) 和 html 規範 (HTML5) 發生了顯著變化，載入現代網頁的效果很差
  - Android >= 5.0 版本
    - WebView元件是一個獨立的應用程式
      - 可以更新
  - Android >= 7.0 版本
    - 安裝並啟用WebView元件後，它會被 Google Chrome 網路瀏覽器的元件取代
      - 可以更新

Git Repo 的組織

陳舊的樹枝
- 01-基礎
  - 用於開發和測試實驗功能的小應用程式集合
- 02-網路廣播-httpclient
  - 使用外部 HTTP 客戶端庫：Apache HttpClient
  - 使用Content-Type響應標頭來偵測視訊文件
- 03-網路廣播-okhttp
  - 使用外部 HTTP 用戶端程式庫：okhttp
  - 使用Content-Type響應標頭來偵測視訊文件
- 04-網路廣播-檔案名
  - 使用WebView下載所有HTTP請求
  - 使用正規表示式偵測 URL 請求中與影片格式關聯的檔案副檔名
活躍分支
- 05-網路廣播-檔案名稱-media3
  - 使用WebView下載所有HTTP請求
  - 使用正規表示式偵測 URL 請求中與影片格式關聯的檔案副檔名
  - 基於 04-webcast-filename 分支構建，並從 ExoPlayer 遷移到 AndroidX Media3
- 00-chromecast-接收器-應用程式
  - WebCast Chromecast 接收器應用程式
- gh-頁面
  - WebCast Chromecast 接收器應用程式
    - 該分支的HEAD應始終引用/別名 00-chromecast-receiver-app 分支的HEAD
  - 由 GitHub Pages 託管