文件結構
在 Brightcove，我們努力保持文檔的結構化，乾淨和直觀。因此，我們利用 github Readme 獲取有關我們所有插件和集成的詳細信息。為了方便起見，我們已列出並連結至下列這些外掛程式。
支援的版本
適用於 iOS 的本機 SDK 支持以下 iOS 版本：
主動支援
Brightcove 在以下 iOS 版本的最新公開發布中為最新的 iOS SDK 提供積極支持：
- iOS 16
- iOS 15.7
- iOS 14.8
- iOS 13.7
被動支援
布萊特灣為以下 iOS 版本提供被動支援：
- iOS 12.5.3
- iOS 11.4.1（如果您想使用 IMA 廣告，您需要 iOS 12.5.3 或更高版本）
瞭解支援等級
支持是根據 [major version]定義的。 [次要版本] 。操作系統的[補丁版本] （例如：iOS 12.5.3）。為了充分利用 Apple 的最新技術改進，我們提供兩種等級的支援：
- 作用中：Brightcove 將測試和修復這些操作系統版本的錯誤。
- 被動式：Brightcove 將在這些操作系統版本上進行測試，但錯誤修復將根據個別情況進行處理。
一般而言，Brightcove 為 80% 的使用者群所使用的作業系統版本提供主動支援，並針對至少 5% 的使用者群使用的其他版本所使用的被動式支援。
入門
在開始使用適用於 iOS 的 Native SDK 進行開發之前，您應該了解一些概念：
- 媒體
當前版本的 Native SDK 支持通過 Playback API 播放您的 Video Cloud 帳戶中的內容，或作為具有 Internet 可訪問 URL 的遠程資產。
- 分析
借助 Native SDK，Video Cloud 客戶可以自動獲得 Video Cloud 中報告的強大分析數據。
- 核心 SDK 和相依性
可以使用 CocoaPods 依賴管理器將適用於 iOS 的 Brightcove Native SDK 及其插件添加到您的項目中。所有 Brightcove Native SDK 組件的 podspecs 都託管在 BrightcoveSpecs 存儲庫中。
- 原生 SDK 參考
了解 Native SDK，包括安裝、快速入門和架構。您將了解關鍵組件如何交互以處理控製本機視頻播放器的複雜性。
您還會找到最新的 SDK 測試版（如果存在）。
- 本機SDK概述
了解 Brightcove Native SDK 組件如何與本機 iOS 組件交互。
- 視頻培訓
觀看一系列訓練影片，引導您完成在 Xcode 中建置 Swift 應用程式的步驟，並從您的 Video Cloud 媒體櫃播放影片。
- 郵件列表
加入 Brightcove Native SDKs 郵件列表，隨時了解 Native SDKs 的發佈公告。
下載開發套件
Brightcove Native SDK for iOS 包含兩個安裝包：
- 支持以下內容的動態框架：
- iOS 12 及更高版本
- tvOS 12.0 及更高版本
獲取適用於 iOS 的布萊特灣原生 SDK 的最新版本：
| 包裹 （Github 回購） |
Podspec | 參考 文檔 |
注意事項 | 樣本 | |
|---|---|---|---|---|---|
| SDK | 適用於 iOS 6.12.0 的原生 SDK | 亮度規格特定 | SDK 參考 | 版本資訊 | 樣例應用 |
或選取此按鈕：
要查看所有 Native SDK 和相關插件的產品更新，請參閱Brightcove 本機 SDK 發行說明文檔。
整合
下表包含連結，以取得與 SDK 實作整合的外掛程式。這些插件可以從各自的 Gitthub 回購中下載，並且每個回購都包含詳細的 README，其中包含有關如何設置插件的說明。
範例應用程式示範與 SDK 整合的每個外掛程式的基本功能。這些示例應用程序是了解每個插件的好方法，並作為調試時的參考點。
| 類別 | Brightcove 插件 （Github 回購） |
Podspec | 參考文件 | 範例應用程式 | 支援的合作夥伴/廠商外掛 |
|---|---|---|---|---|---|
| 廣告 | IMA 插件 6.12.0 [1] [2] | 亮海玩家-SDK-伊瑪 | IMA 參考 | 谷歌 IMA 樣本 | 谷歌 IMA SDK 3.18.1 |
| FreeWheel 插件 6.12.0 | Brightcove-Player-SDK-FW | 飛輪參照 | 飛輪樣本 | FreeWheel 廣告管理器 6.52.0 | |
| 脈衝插件 6.12.0 | 亮海玩家-脈衝 | 脈衝參考 | 脈衝樣本 | 脈衝 SDK 2.6.21.6.0 | |
| SSAI 插件 6.12.0 | Brightcove-Player-SDK-FW | SAI 參考 | SAI 樣本 | VAST 4.1 廣告驗證 | |
| 分析 | Omniture 插件 6.12.0 | Brightcove-Player-SDK裝置 | Omniture參考 | Omniture樣本 | Adobe Video Heartbeat 2.3.0 Adobe 營銷雲 4.21.2 |
| 鉻 | GoogleCast 插件 6.12.0 | Brightcove-Player-GoogleCast | GoogleCast參考 | GoogleCast示例 | Google Cast SDK 4.6.1 |
合併外掛程式
借助適用於 iOS 的 Native SDK，BCOVSessionProviders從每個插件中創建並鏈接在一起。然後使用該鏈創建BCOVPlaybackController .有關詳細信息，請參閱結合插件部分 SDK 參考。
使用 IMA 插件投放廣告
VAST 廣告的放置位置通常由 VMAP 文件指定。VAST 說明廣告，而 VMAP 則描述影片中廣告的位置。詳細代碼見BasicIMAPlayer iOS樣本。
使用 IMA 廣告時，最好先檢查您的廣告是否在 SDK 以外運作，然後再實施這些廣告。以下鏈接將有助於此：
樣本
如需範例和程式碼片段，請參閱下列內容：
下表包含程式碼範例的連結，這些連結除了與上一節中整合相關聯的範例。
| 範例應用程式 | 描述 |
|---|---|
| 360°視頻 | 只要設定投影屬性，就能播放 360° 視訊。點選控制列中的「視訊 360 視訊」按鈕時，視訊會以 VR 護目鏡模式顯示並排影像。有關詳細信息，請參閱將 360° 視頻與原生 SDK 結合使用文檔。 |
| 基本樣本 | 從視訊雲端播放清單播放視訊。 |
| 鉻 | 透過您的 iOS 裝置透過 Google 瀏覽器顯示影片。 |
| 自定義字幕樣式 | 您可以通過實現自己的字幕渲染來更改字幕樣式。此示例在不覆蓋視頻的視圖中呈現字幕。 |
| DRM與FairPlay | 使用 FPS (FPS) 保護您的內容。 |
| 錄像機直播[1] | 執行 HLS 即時串流。 |
| 本機控件 | 使用 iOS 原生播放程式控制項。 |
| 離線播放 | 下載並播放 HLS 影片，包括受 FairPlay 加密保護的影片。有關概述，請參閱使用原生 SDK 進行離線播放文檔。有關開發人員的詳細信息，請參閱離線播放的 iOS 應用開發者指南 . |
| 玩家界面自定義 | 嘗試數種不同的自訂控制項版面配置。這Brightcove PlayerUI 控件提供開箱即用的 AirPlay 功能。如果您想使用自己的控件實現 AirPlay，請參閱AirPlay 的自定義控件代碼片段。 |
| 附屬字幕 | 顯示影片的字幕，其中包含在個別檔案中。 |
解決方案指南
下表包含指向開發人員文檔的鏈接，這些文檔將幫助您開始使用 Brightcove Native SDK 開發您自己的應用程序，並指導您了解一些可用的特性和功能。
| 指南 | 描述 |
|---|---|
| Brightcove 分析 | 視訊雲端客戶將學習如何使用 iOS 適用於 Brightcove SDK 的行動應用程式，在 Brightcove 分析中設定屬性。 |
| 適用於 iOS 設置的 Brightcove 本機 SDK | 通過引導您使用您自己的後端系統中的內容開發一個簡單的視頻播放應用程序，了解使用適用於 iOS 的 Brightcove Native SDK 的基礎知識。 Video Cloud 客戶還將從 Brightcove Catalog 服務中檢索和播放視頻。 |
| IAB 開放測量 | 了解如何搭配 IMA 外掛程式使用開放度量 SDK，以支援廣告評量和驗證的協力廠商工具。 |
| 來源選擇 | 瞭解播放視訊時的預設轉譯選取程序。 |
| WebVTT字幕 | 了解如何在使用 iOS 版原生 SDK 時，為 HLS 影片設定 WebVTT 字幕。 |
平台說明
以下說明與 iOS 平台相關。
使用 Airplay 鏡像屏幕
AirPlay 功能與適用於 iOS 的 Native SDK 開箱即用，允許用戶使用 Apple TV 將視頻流式傳輸到高清顯示器。
您可以使用 Brightcove 控件，或使用您自己的 AirPlay 自定義控件。有關詳細信息，請參閱 AirPlay 代碼片段的自定義控件 。