サポート問い合わせ先| システムステータス
ページコンテンツ

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

    このトピックでは、iOS/tvOS 用 Brightcove ネイティブ SDK に関連付けられたサンプルアプリを実行する方法について説明します。これらのサンプルは、独自のアプリを作成するための良い出発点を提供します。

    概要

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

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

    必要なツール

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

    • Xcode 15以降

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

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

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

    サンプルタイプ

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

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

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

    サンプルは、次の言語で記述されています。

    • Objective-C

      Objective-Cは、Cプログラミング言語のスーパーセットであり、オブジェクト指向の機能と動的ランタイムを提供します。だから、それはクラスとメソッドを定義するための構文を追加します。

    • スウィフト

      スウィフトは、iOS、Mac、tvOS、アップルウォッチのための新しいオープンソースプログラミング言語です。より直感的に使用でき、JavaScript に似ています。これは、既存のObjective-Cコードに追加することができます。

    サンプルを開く

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

    ほとんどのサンプルは、Swift Package Manager 経由で Brightcove ネイティブ SDK とその第三者依存関係を使用します。Xcode は初回ビルド時にパッケージを自動的に解決するため、プロジェクトを開く前に追加の手順は不要です。例外は PlayerUI/Flutter と PlayerUI/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. ターミナルでサンプルの ios/ フォルダに移動し、pod install を実行します。
      Run pod install
      ポッドのインストールを実行
    4. 生成された .xcworkspace ファイルを Xcode で開きます。

    サンプルアプリの実行

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

    • Xcodeシミュレータ
    • コンピュータに接続された物理デバイスを使用するXcode
      • デバイスは iOS 14 以降（tvOS サンプルの場合は tvOS 15 以降）が必要です。
      • デバイスで、USB デバッグが有効になっていることを確認します。

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

    1. Xcode を初めて使用する場合は、 Apple 開発者向けドキュメントを参照してください。
    2. Xcode で、サンプルの .xcodeproj（Flutter および React Native サンプルの場合は .xcworkspace）を開きます。
      Project in Xcode
      Xcodeでのプロジェクト
    3. メインのビューコントローラのソースファイルを開きます。サンプルは、指定された値で実行することも、独自の Video Cloud アカウント ID、動画 ID、ポリシーキーに置き換えることもできます。
      Customize values
      値をカスタマイズする
    4. ツールバーのアクティブなスキームメニューで、サンプルのプロジェクトが選択されていることを確認します。
      Project selection
      プロジェクトの選択
    5. 実行先のドロップダウンを展開します。コンピュータに接続しているデバイスがある場合は、ここにデバイスが表示されます。デバイスまたはシミュレータのバージョンを選択します。
      Select device or simulator version
      デバイスまたはシミュレータのバージョンを選択
    6. 「実行」ボタンを選択します。
      Run the project
      プロジェクトを実行する
    7. お使いのデバイスまたはシミュレータで実行されているアプリが表示されます。
      Xcode simulator
      Xcodeシミュレータ

    デバッグ

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

    1. Xcodeで、実行を一時停止したいコードの行を見つけます。
    2. コード行の左側溝で、をクリックしてブレークポイントを追加します。ダブルクリックしてブレークポイントを編集します。ブレークポイントを右クリックすると、ブレークポイントの削除を含むオプションが表示されます。
      Breakpoint
      ブレークポイント
    3. 「実行」ボタンを選択して実行を開始します。
      Run the project
      プロジェクトを実行する

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

      Pause execution at breakpoint
      ブレークポイントで実行を一時停止
    ページの最終更新日04 Oct 2021