iOS / tvOS用のネイティブSDKのサンプルアプリの実行

概要

iOS/tvOS 用 Brightcove ネイティブ SDK には、独自の実装を始めるのに役立つさまざまなサンプルアプリが用意されています。サンプルの完全なリストについては、以下を参照してください。

• iOS/tvOS のプレーヤーサンプル

Brightcoveのネイティブ SDK を初めて使用する場合は、「ネイティブ SDK の使用開始」動画をご覧ください。

必要なツール

サンプルアプリを実行するには、コンピューターに次のツールがインストールされている必要があります。

• Xcode 15以降

  Xcode （エックスコード）は、macOS、iOS、watchOS、tvOS用のソフトウェアを作成するために使用される統合開発環境 (IDE) である。

• （Flutter および React Native サンプルのみ）CocoaPods 1.11 以降

  ほとんどのサンプルは Swift Package Manager 経由で Brightcove SDK を使用するため、追加のツールは不要です。Flutter と ReactNative サンプルは iOS 統合に CocoaPods を使用するため、CocoaPods のインストールが必要です。

サンプルタイプ

iOS/tvOS リポジトリのプレーヤーサンプルには、次のプラットフォームのサンプルがあります。

• iOS-iPhone、iPad、iPodを含むアップルデバイス用のモバイルオペレーティングシステム

• tvOS-Apple TV用のオペレーティングシステム

サンプルアプリは Swift で書かれています。SDK は Objective-C もサポートしており、ステップバイステップガイドにはObjective-C 版も用意されています。

サンプルを開く

iOS/tvOS サンプルアプリは、最新バージョンの Brightcove ネイティブ SDK とプラグインをサポートしています。

ほとんどのサンプルは、Swift Package Manager 経由で Brightcove ネイティブ SDK とその第三者依存関係を使用します。Xcode は初回ビルド時にパッケージを自動的に解決するため、プロジェクトを開く前に追加の手順は不要です。例外は Flutter と ReactNative サンプルで、iOS 統合に CocoaPods を使用します。

ほとんどのサンプル（Swift Package Manager）

1. iOS/tvOS 用の Player サンプルをクローンまたはダウンロードします。
2. サンプルの .xcodeproj ファイルを Xcode で開きます。
3. Xcode が初回ビルド時に Swift Package を解決します。Xcode タイトルバーの「Fetching Package Dependencies」が完了するまでお待ちください。

IMA、DAI、FreeWheel、Pulse、Omniture サンプルは、Brightcove が再配布しない第三者広告または分析 SDK に依存します。サンプルの README.md を参照して、追加の手動手順（例：FreeWheel アカウントから取得した FreeWheel AdManager xcframework をドロップインする）を確認してください。

Flutter および React Native サンプル（CocoaPods）

1. CocoaPods をまだお持ちでない場合は、最新バージョンをダウンロードしてインストールしてください。
2. iOS/tvOS 用の Player サンプルをクローンまたはダウンロードします。
3. ネイティブ依存関係を準備してインストールします。2 つのサンプルではディレクトリが異なります。
   • Flutter: Flutter/flutter_bcov フォルダで flutter pub get を実行します。次に Flutter フォルダで pod install を実行します。
   • React Native: ReactNative フォルダで yarn install を実行します。次に ReactNative/ios フォルダで pod install を実行し、yarn start で Metro を起動します。

   必要なフレームワークツールについては、各サンプルの README.md を参照してください。

   

4. 生成された .xcworkspace ファイルを Xcode で開きます。

サンプルアプリの実行

サンプルアプリは、以下を使用して実行できます。

• Xcodeシミュレータ
• コンピュータに接続された物理デバイスを使用するXcode
  • デバイスは iOS 14 以降（tvOS サンプルの場合は tvOS 15 以降）が必要です。
  • デバイスで開発者モードを有効にし、求められたらこのコンピュータを信頼します。iOS と tvOS には Android の USB デバッグはありません。

サンプルアプリを実行するには、次の手順に従います。

1. Xcode を初めて使用する場合は、 Apple 開発者向けドキュメントを参照してください。
2. Xcode で、サンプルの .xcodeproj（Flutter および React Native サンプルの場合は .xcworkspace）を開きます。

   

3. メインのビューコントローラのソースファイルを開きます。サンプルは、指定された値で実行することも、独自の Video Cloud アカウント ID、動画 ID、ポリシーキーに置き換えることもできます。

   

4. ツールバーのアクティブなスキームメニューで、サンプルのプロジェクトが選択されていることを確認します。

   

5. 実行先のドロップダウンを展開します。コンピュータに接続しているデバイスがある場合は、ここにデバイスが表示されます。デバイスまたはシミュレータのバージョンを選択します。

   

6. 「実行」ボタンを選択します。

   

7. お使いのデバイスまたはシミュレータで実行されているアプリが表示されます。

   

デバッグ

Xcodeには、ブレークポイントの設定、変数の確認、実行時の式の評価を可能にするデバッグツールが用意されています。アプリをデバッグするには、次の操作を行います。

1. Xcodeで、実行を一時停止したいコードの行を見つけます。
2. コード行の左側溝で、をクリックしてブレークポイントを追加します。ダブルクリックしてブレークポイントを編集します。ブレークポイントを右クリックすると、ブレークポイントの削除を含むオプションが表示されます。

   

3. 「実行」ボタンを選択して実行を開始します。

   

4. ブレークポイントで実行が一時停止すると、変数と式を調べるだけでなく、コード行の上/上/へのステップインを行うオプションがいくつかあります。