概述：適用於 tvOS 的布萊特灣原生 SDK

概覽

適用於 TVOS 的原生 SDK 可讓您為 Apple TV 建立以視訊為中心的應用程式。

視頻雲客戶可以播放視頻雲庫內容
布萊特灣玩家的客戶可以使用互聯網可訪問的 URL 播放視頻

在擷取內容時，我們建議您使用高解析度描述檔，以便為 Apple TV 提供最佳轉譯。有關詳細信息，請參閱 Apple 的Apple TV 的視頻格式文檔。

支援的版本

主動支援

Brightcove 在以下 tvOS 版本的最新公開發行版上為最新的 tvOS SDK 提供積極支持：

蘋果 16
tvOS 15.6
tvOS 14.7
tvOS 13.4.8

被動支援

布萊特灣為以下 tvOS 版本提供被動式支援：

電子產品 12.4.1
tvOS 11.4.1（如果您想使用 IMA 廣告，則需要 tvOS 12.4.1 或更新版本）

瞭解支援等級

支持是根據[主要版本] . [次要版本] . [補丁版]操作系統（例如：tvOS 11.4.1）。為了充分利用 Apple 的最新技術改進，我們提供兩種等級的支援：

作用中：Brightcove 將測試和修復這些操作系統版本的錯誤。
被動式：Brightcove 將在這些操作系統版本上進行測試，但錯誤修復將根據個別情況進行處理。

一般而言，Brightcove 為 80% 的使用者群所使用的作業系統版本提供主動支援，並針對至少 5% 的使用者群使用的其他版本所使用的被動式支援。

入門

在開始使用適用於 tvOS 的 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 存儲庫中。

需要版本 1.0 或更新版本。
原生 SDK 參考
了解 Native SDK，包括安裝、快速入門和架構。您將了解關鍵組件如何交互以處理控製本機視頻播放器的複雜性。

您還會找到最新的 SDK 測試版（如果存在）。
郵件列表
加入 Brightcove Native SDKs 郵件列表，隨時了解 Native SDKs 的發佈公告。

頻道中的帖子僅供歷史參考。註冊會將您添加到 SDK 版本的電子郵件列表中。

下載開發套件

適用於 tvOS 的 Brightcove Native SDK 包含在適用於 iOS 的 Native SDK 中。在這裡，你會發現一個支持 tvOS 的動態庫框架。

獲取適用於 iOS 的布萊特灣原生 SDK 的最新版本：

	包裹（Github 回購）	Podspec	參考文檔	注意事項	範例
SDK	適用於 iOS 6.12.0 的原生 SDK	亮度規格特定	SDK 參考	版本資訊	基本的Apple TV示例

或選取此按鈕：

要查看所有 Native SDK 和相關插件的產品更新，請參閱Brightcove 本機 SDK 發行說明文檔。

注意事項：

適用於 iOS 框架的所有 Brightcove Native Player 的最低部署目標現在是 iOS 12 和 tvOS 12
為了提高合規性，iOS 6.7.7 的原生 SDK 已重命名了一些 Podspec 文件。有關詳細信息，請參閱原生 SDK 參考 .
適用於 iOS 6.5.0+ 的布萊特灣原生 SDK 需要 Xcode 11.0 或更高版本。
在您的項目中需要自動引用計數（ARC）。這是 Xcode 項目的當前默認值。
TVOS 的布萊特灣原生 SDK 是為了允許您創建使用 Obj-C 和 Swift 的自定義應用程序，但它不支持蘋果的電視標記語言（TVML）。
FairPlay 串流內容有一個已知的 Apple 問題，就是它不會以 AirPlay 鏡像輸出模式呈現。有關詳細信息，請參閱WWDC 演示：HLS 的內容保護 (大約捲動成績單的一半)。

整合

下表包含連結，以取得與 SDK 實作整合的外掛程式。這些插件可以從各自的 Gitthub 回購中下載，每個回購都包含詳細的 README，並提供有關如何設置插件的說明。

範例應用程式示範與 SDK 整合的每個外掛程式的基本功能。這些示例應用程序是了解每個插件的好方法，並作為調試時的參考點。

以前的集成版本

類別	插入（Github 回購）	Podspec	參考文件	範例應用程式	支援的合作夥伴/廠商外掛
廣告	IMA 插件 6.12.0 ^[1] ^[2]	亮海玩家-SDK-伊瑪	IMA 參考	谷歌 IMA 樣本	谷歌 IMA SDK 4.6.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 廣告驗證

下列注意事項參考上表中的整合。

^[1] IMA 插件的當前版本支持 Google 的 IMA iOS SDK v3，它支持 iOS 9.0+ 版本。有關詳細信息，請參閱谷歌的文檔 .

Brightcove 本機 SDK 支持VMAP包含 VAST 協議的 XML 模板，包括浩瀚3.0 , 以及有限的支持浩瀚4.0 .有關 VAST 版本兼容性的更多詳細信息，請參閱Google 的支持和兼容性文檔適用於 iOS 的 IMA SDK。

適用於 tvOS 的原生 SDK 支持 IAB Open Measurement SDK v3.1.22。

^[2]如果您使用的是 Swift，則必須手動添加 Google 的 IMA 庫，而不是使用 CocoaPods。這是因為谷歌的 IMA 庫不支持動態框架，並且 Swift 不支持構建靜態庫。有關詳細信息，請參閱手動的的部分適用於 iOS 的 Brightcove 本機 SDK 的 IMA 插件文檔。即使 Brightcove 的 IMA 插件使用動態框架，谷歌 IMA 庫只作為一個靜態框架提供。

樣本

下表包含程式碼範例的連結，這些連結除了與上一節中整合相關聯的範例。

範例應用程式	描述
蘋果電視	建立基本應用程式，從您的視訊雲端媒體櫃播放視訊。
用FairPlay播放	使用 FPS (FPS) 保護您的內容。有關完整示例，請參閱基本公平競賽 iOS 示例。
附屬字幕	顯示影片的字幕，其中包含在個別檔案中。這是 iOS 範例，但應該與 tvOS 相關。

解決方案指南

下表包含指向開發人員文檔的鏈接，這些文檔將幫助您開始使用 Brightcove Native SDK 開發您自己的應用程序，並指導您了解一些可用的特性和功能。

指南	描述
使用Apple TV UI控件	了解如何利用適用於 TVOS 的布萊特灣原生 SDK 來使用電視播放器控制項。
簡單的視頻播放	了解如何使用適用於 tvOS 的 Brightcove 原生 SDK 來建立簡單的視訊應用程式。
來源選擇	瞭解播放視訊時的預設來源選取程序。
使用網路 VTT 字幕	了解如何在使用 TVOS 的原生 SDK 時，為 HLS 影片設定 WebVTT 字幕。

最佳實務

以下是您在使用 Brightcove 原生 SDK 時可能會有幫助的其他資訊。