概要：tvOS用のBrightcovePlayer SDK

概要

tvOS 用のネイティブ SDK を使用すると、Apple TV 用のビデオ中心のアプリを作成できます。

• Video Cloud のお客様は、Video Cloud ライブラリのコンテンツを再生できます
• Brightcoveプレーヤーのお客様は、インターネットにアクセス可能な URL で動画を再生できます

コンテンツを取り込むときは、Apple TV に最適なレンディションを実現するために、高解像度プロファイルを使用することをお勧めします。詳細については、 Apple TV のビデオフォーマットに関するドキュメントを参照してください。

サポートされているバージョン

アクティブなサポート

Brightcoveは、次のtvOSバージョンの最新のパブリックリリースで最新のtvOSSDKをアクティブにサポートします。

• tvOS 14
• tvOS 13.4.8
• tvOS 12.4.1

パッシブサポート

Brightcoveは、次の tvOS バージョンに対してパッシブサポートを提供しています。

• tvOS 11.4.1

サポートレベルを理解する

サポートは [メジャーバージョン] で定義されています。[ マイナーバージョン] OS の [パッチバージョン] (例:tvOS 11.4.1)。Appleの最新のテクノロジー向上を活用するために、2つのレベルのサポートを提供しています。

• アクティブ :Brightcoveは、これらの OS バージョンのバグをテストし、修正します。
• パッシブ :BrightcoveはこれらのOSバージョンのテストを行いますが、バグの修正についてはケースバイケースで処理されます。

通常Brightcoveはユーザー基盤の80%に使用されているOSバージョンについてアクティブなサポートを提供し、他のバージョンについては、ユーザー基盤の5%以上に使用されているものに対してはパッシブなサポートを提供します。

Swift Package Manager でインストールする（推奨）

Brightcove Native SDK for tvOS は、プラグインごとに 1 つのライブラリ製品を公開する単一の Swift パッケージとして配布されます。いずれかのプラグイン製品を追加すると Core SDK が自動的に取り込まれるため、実際に使用する製品だけを追加すれば十分です。

各プラグイン製品は、必要な第三者の広告 SDK（Google IMA など）も解決し、必要なシステムフレームワークを自動的にリンクするため、ほとんどのプラグインでは追加の作業は不要です。FreeWheel と Pulse の各プラグインは、Swift Package Manager で配布されていないベンダー SDK を別途必要とします。手動の手順については各プラグインのリファレンスページを参照してください。

1. Xcode で File > Add Package Dependencies を選択します。
2. パッケージ URL を貼り付けます: https://github.com/brightcove/brightcove-player-sdk-ios
3. 必要な内容に合わせてライブラリ製品を選択します:

   ライブラリ製品	含まれる内容
   BrightcovePlayerSDK	Core SDK のみ
   BrightcoveIMA	Core + Google IMA プラグイン
   BrightcoveDAI	Core + Google DAI プラグイン
   BrightcoveFW	Core + FreeWheel プラグイン
   BrightcoveGoogleCast	Core + Google Cast プラグイン（iOS のみ、tvOS では利用不可）
   BrightcoveAMC	Core + Omniture プラグイン（iOS のみ、tvOS では利用不可）
   BrightcovePulse	Core + Pulse プラグイン
   BrightcoveSSAI	Core + SSAI プラグイン
   OMSDK_Brightcove	Open Measurement SDK（BrightcoveSSAI と併用）

独自のプロジェクト自体が Swift パッケージである場合は、Package.swift に依存関係を宣言します。各プラグイン製品にはすでに Core SDK が含まれているため、使用するプラグイン製品のみを指定します:

// Package.swift
let package = Package(
    // ...
    dependencies: [
        .package(url: "https://github.com/brightcove/brightcove-player-sdk-ios.git", from: "X.Y.Z")
    ],
    targets: [
        .target(
            name: "MyApp",
            dependencies: [
                .product(name: "BrightcoveIMA", package: "brightcove-player-sdk-ios")
            ]
        )
    ]
)

CocoaPods でインストールする（非推奨）

Brightcove Native SDK for tvOS とそのプラグインは、CocoaPods 依存関係マネージャを使用してプロジェクトに追加することもできます。すべての Brightcove Native SDK コンポーネントの Podspec は、BrightcoveSpecs リポジトリでホストされています。

入門編

Player SDK for tvOS の開発を開始する前に、いくつかの概念について学習する必要があります。

1. メディア

   Native Player SDK の現在のバージョンでは、再生 API を介して Video Cloud アカウントからコンテンツを再生したり、インターネットにアクセスできる URL を持つリモートアセットとしてコンテンツを再生できます。

2. アナリティクス

   ネイティブプレーヤー SDK を使用すると、Video Cloud のお客様は、Video Cloud でレポートされた堅牢な分析データを自動的に取得します。

3. SDK のインストール

   Brightcove Native SDK for tvOS とそのプラグインをプロジェクトに追加する推奨方法は Swift Package Manager です。CocoaPods もサポートされていますが、非推奨です。

4. ネイティブ SDK リファレンス

   SDK を理解しやすくするために、Player SDK でアーキテクチャの詳細な内訳を見つけることができます。ネイティブビデオプレーヤーを制御する複雑さを処理するために、重要なコンポーネントがどのように相互作用するかについて説明します。プレーヤー SDK のインストール、クイックスタート、およびアーキテクチャ

   ここには、SDK の最新ベータバージョン（存在する場合）も表示されます。

5. 質問と回答

   SDK 開発者フォーラムにご参加ください。SDK 関連の質問には、Brightcoveのエンジニアとコミュニティが回答します。以前に回答した質問を検索するか、新しい質問を投稿します。パブリックグループとして、電子メールアドレスを指定してアクセスすることができます。

SDKのダウンロード

tvOS 用 Brightcove Player SDK は、iOS 用 Player SDK に含まれています。ここでは、tvOSをサポートする動的ライブラリフレームワークがあります。

iOS 版 Brightcove ネイティブ SDK の最新バージョンを入手する:

または、このボタンを選択します。

すべてのネイティブ SDK および関連するプラグインの製品アップデートを確認するには、 Brightcove ネイティブ SDK ドキュメントのリリースノートを参照してください。

統合

次の表に、SDK 実装と統合するプラグインを取得するためのリンクを示します。プラグインはそれぞれのGithub Reposからダウンロードでき、各リポジトリには、プラグインの設定方法に関する詳細なREADMEが含まれています。

サンプルアプリケーションは、SDK に統合された各プラグインの基本機能を示しています。これらのサンプルアプリは、各プラグインについて学習するのに良い方法であり、デバッグ時の参照ポイントとして機能します。

以前の統合バージョン

以下のすべてのプラグインは、https://github.com/brightcove/brightcove-player-sdk-ios にある統一 Brightcove Swift Package を通じて配布されます。パッケージを一度追加し、必要なライブラリ製品を選択してください。詳細については、上記のSwift Package Manager でインストールするを参照してください。

サンプル

次の表には、前のセクションの統合に関連付けられたサンプルに加えて、コードサンプルへのリンクが含まれています。

ソリューションガイド

次の表に、Brightcove Player SDK を使用して独自のアプリを使い始めるのに役立つ開発者ドキュメントへのリンクと、利用可能な機能の一部について説明します。

ベストプラクティス

ここでは、Brightcove ネイティブ SDK で作業する際に役立つ追加情報を示します。

広告

Apple TV では、コンパニオン広告とクリックスルー広告はサポートされていません。Apple TV では Web ブラウザーのサポートがないため、クリックスルー URL の宛先はありません。