ドキュメントの構成
Brightcoveでは、ドキュメントを構造化し、クリーンで直感的なものになるように努めています。そのため、すべてのプラグインと統合の詳細については、github READMEs を活用しています。便宜上、これらのプラグインの一覧とリンクを以下に示します。
サポートされているバージョン
iOS 用ネイティブ プレーヤー SDK では、次のバージョンの iOS がサポートされています。
アクティブ サポート
Brightcoveは、次のiOSバージョンの最新のパブリック リリースにおいて、最新のiOS SDKをアクティブにサポートしています。
- iOS 18
- iOS 17
- iOS 16
- iOS 15.7
- iOS 14.8
- iOS 13.7
パッシブ サポート
Brightcoveは、次の iOS バージョンに対してパッシブサポートを提供しています。
- iOS 12.5.3
サポートレベルを理解する
サポートは、OSの [メジャーバージョン] 、[ マイナーバージョン] 、 [パッチバージョン] で定義されています。(例: iOS 12.5.3)。Appleの最新技術の向上を活用するため、2つのレベルのサポートを提供しています。
- アクティブ : Brightcoveは、これらの OS バージョンのバグをテストし、修正します。
- パッシブ : Brightcoveは、これらのOSバージョンのテストを行いますが、バグの修正についてはケース・バイ・ケースで対応します。
通常、Brightcoveは、ユーザー ベースの80%が使用するOSバージョンに対してアクティブなサポートを提供し、ユーザー ベースの5%が使用する、その他のバージョンに対しては、パッシブなサポートを提供します。
はじめに
iOS 用 Player SDK の開発を開始する前に、学んでおくべき、いくつかのコンセプトがあります。
- メディア
現在のバージョンの ネイティブ SDK は、Playback API を通じて Video Cloud アカウントから、またはインターネットからアクセス可能な URL を持つリモート アセットとして、コンテンツの再生をサポートしています。
- アナリティクス
ネイティブ SDK を使用すると、Video Cloud の顧客は自動的に Video Cloud で報告される堅牢な解析データを取得できます。
- コア SDK と依存関係
iOS 用 Brightcove Player SDK とそのプラグインは、CocoaPods 依存関係マネージャを使用してプロジェクトに追加できます。すべての Brightcove Player SDK コンポーネントのPodspecは、 BrightCoveSpecs リポジトリでホストされます。
- ネイティブ SDK リファレンス
SDK を理解しやすくするために、iOS 用 Player SDK でアーキテクチャの詳細な内訳を見つけることができます。ネイティブ ビデオプレーヤーを制御する複雑さを処理するために、重要なコンポーネントがどのように相互作用するかについて説明します。
ここには、SDK の最新ベータバージョン(存在する場合)も表示されます。
- ネイティブ SDK の概要
Brightcove Player SDK コンポーネントが ネイティブ iOS コンポーネントとどのように相互作用するかを説明します。
- ビデオ トレーニング
Video Cloud ライブラリからビデオを再生する、Swift アプリを Xcode で構築する手順を説明する一連のトレーニング ビデオをご覧ください。
- メーリングリスト
Brightcove ネイティブ SDKs メーリングリストに参加し、ネイティブ SDKs のリリース情報を入手することができます。
SDKのダウンロード
iOS 用 Brightcove Player SDK には、次の 2 つのインストールパッケージが含まれています。
- 次の機能をサポートする動的なフレームワーク:
- iOS 12以上
- tvOS 12.0以上
iOS 版 Brightcove ネイティブ SDK の最新バージョンを入手する:
パッケージ (Githubリポジトリ) |
Podspec | 参考 ドキュメンテーション |
注 | サンプル | |
---|---|---|---|---|---|
SDK | iOS 6.12.5用のネイティブSDK | BrightcoveSpecs | SDKリファレンス | リリースノート | サンプルアプリケーション |
または、このボタンを選択します。
すべてのネイティブ SDK および関連するプラグインの製品アップデートを確認するには、 Brightcove ネイティブ SDK のリリースノートを参照してください。
統合
次の表に、SDK 実装にプラグインを統合するためのリンクです。プラグインはそれぞれのGithubリポジトリからダウンロードでき、各リポジトリにはプラグインの設定方法に関する詳細なREADMEが含まれています。
サンプル アプリケーションは、SDK と統合された各プラグインの基本的な機能を示しています。これらのサンプル アプリは、各プラグインについて学習するのに良い方法であり、デバッグ時の参照ポイントとしても役立ちます。
カテゴリ | Brightcoveプラグイン (Githubリポジトリ) |
Podspec | リファレンス・ドキュメント | サンプルアプリ | サポートされているパートナー/ベンダープラグイン |
---|---|---|---|---|---|
広告 | IMAプラグイン6.12.5 [1][2] | Brightcove Player-SDK-ima | IMAリファレンス | Google IMAサンプル | Google IMA 3.19.1 |
FreeWheelプラグイン6.12.5 | Brightcove-Player-SDK-FW | FreeWheelリファレンス | FreeWheel サンプル | FreeWheel Ad Manager 6.52.0 | |
Pulseプラグイン6.12.5 | Brightcove Player-Pulse | Pulseリファレンス | Pulseサンプル | Pulse SDK 2.6.21.6.0 | |
SSAIプラグイン6.12.2 | Brightcove-Player-SDK-FW | SSAIリファレンス | SSAIサンプル | VAST 4.1 AdVerification | |
アナリティクス | Omnitureプラグイン6.12.5 | Brightcove-Player-SDK Omniture | Omnitureリファレンス | Omnitureサンプル | Adobe Video Heartbeat 2.3.0 Adobe Marketing Cloud 4.21.2 |
Chromecast | GoogleCastプラグイン6.12.2 | Brightcove-player-GoogleCast | GoogleCastリファレンス | GoogleCastサンプル | GoogleCast SDK 4.8.0 |
プラグインの組み合わせ
iOS 用のネイティブ SDK では、各プラグインのBCOVSessionProviders
が作成され、連結されます。このチェーンを使用して、BCOVPlaybackController
を作成します。詳細については、「SDK リファレンス」のプラグインの組合せセクションを参照してください。
IMAプラグインによる広告
VAST 広告の配置は通常、 VMAP ドキュメントによって指定されます。VAST は広告を記述し、VMAP は動画内の広告の配置を記述します。コードの詳細については、 Basic IMA Player iOS のサンプルを参照してください。
IMA広告を使用する場合は、SDKの外部で広告が機能することを確認してから実装することをお勧めします。このためには、次のリンクが役立ちます。
サンプル
サンプルとコード スニペットについては、以下を参照してください。
次の表には、前のセクションの統合に関連するサンプルに加えて、コード サンプルへのリンクが含まれています。
サンプル アプリケーション | 説明 |
---|---|
360° ビデオ | プロジェクション・プロパティが設定されている限り、360°ビデオを再生します。コントロールバーの「Video 360」ボタンをタップすると、VR Gogglesモードで横並びの映像が表示されます。詳しくは、 ネイティブSDKで360°ビデオの使用 ドキュメントをご覧ください。 |
基本サンプル | Video Cloud プレイリストから動画を再生します。 |
Chromecast | iOS デバイスから Google Chromecast を使用して動画を表示します。 |
FairPlayによるDRM | FPS (FairPlay ストリーミング) でコンテンツを保護します。 |
DVRライブ[1] | HLS ライブストリームを実行します。 |
ネイティブ コントロール | iOS ネイティブのプレーヤーコントロールを使用します。 |
プレーヤー UI のカスタマイズ | カスタム コントロールのレイアウトをいくつか試してみてください。Brightcove Player UI コントロールは、すぐにAirPlay 機能を提供します。独自のコントロールで AirPlay を実装する場合は、「 AirPlay 用のカスタムコントロール」コードスニペットを参照してください。 |
サイドカー字幕 | 別のファイルに含まれる動画のキャプションを表示します。 |
360° ビデオ | 投影プロパティが設定されている限り、360° ビデオを再生します。コントロールバーの Video 360 ボタンをタップすると、ビデオは VR ゴーグルモードで画像を並べて表示されます。詳細については、ネイティブ SDK で 360° ビデオを使用するドキュメントを参照してください。 |
オフライン再生 | FairPlay 暗号化で保護されているものを含む HLS ビデオをダウンロードして再生します。概要については、「ネイティブ SDK を使用したオフライン再生」ドキュメントを参照してください。開発者向けの詳細については、オフライン再生の iOS アプリ開発者ガイドを参照してください。 |
ソリューション ガイド
次の表に、Brightcove Player SDK を使用して独自のアプリを使い始めるのに役立つ開発者向けのドキュメントへのリンクと、利用可能な機能の一部について説明します。
ガイド | 説明 |
---|---|
iOS 用Brightcove Player SDK セットアップ | 独自のバックエンド システムのコンテンツを使用したシンプルな動画再生アプリの開発を通して、iOS用 Brightcove SDK の基本的な操作方法を学びます。 Video Cloud のお客様は、さらに Brightcove カタログサービスから動画を取得して再生します。 |
IAB Open Measurement | 広告測定と検証のためのサードパーティツールをサポートするIMAプラグインとOpen Measurement SDKの使用方法について説明します。 |
ソース選択 | ビデオを再生時のデフォルトのレンディション選択プロセスについて説明します。 |
Brightcoveアナリティクスの使用 | Video Cloud のお客様は、iOS 用 Brightcove SDK を使用して、モバイル アプリから Brightcove アナリティクスでプロパティを設定する方法を学びます。 |
WebVTT キャプション | iOS 用 ネイティブ SDK を使用するときに HLS ビデオの WebVTT キャプションを設定する方法について説明します。 |
プラットフォーム ノート
以下の注意事項は、iOSプラットフォームに関するものです。
Airplayで画面をミラーリングする
AirPlay機能は、iOS用のネイティブ SDKですぐに使用できるため、ユーザーはAppleTVを使用してビデオを高解像度ディスプレイにストリーミングすることができます。
Brightcove コントロールを使用することも、AirPlay用に独自のカスタムコントロールを使用することもできます。詳細については、 AirPlayのカスタムコントロールコード スニペットを参照して下さい。