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

    Video Cloud カスタムフィールドの作成

    このトピックでは、Brightcove Beacon への同期に必要な Video Cloud カスタム項目について説明します。

    はじめに

    Video Cloud から Brightcove Beacon にインポートされる動画には、Brightcove Beacon で適切に使用するために、充実したメタデータのセットが定義されている必要があります。このドキュメントでは、Studioで新しいカスタムフィールドを作成する方法について説明します。また、Brightcove Beacon に必要なフィールドも定義します。

    カスタムフィールドの作成

    カスタムフィールドを作成するには、次の手順に従います。

    1. Video Cloud Studioにログインします。
    2. ナビゲーションで、[ Admin ] をクリックし、次に[ カスタムフィールド ] をクリックします。管理者メニューにアクセスするには、アカウント管理者である必要があります。
    3. [カスタムフィールド] ページには、以下のスクリーンショットのように、カスタムフィールドと標準のビデオメタデータフィールドが表示されます。
    4. [ カスタムフィールドの追加 ] をクリックします。
    5. [ 表示名]を入力します。これは、UploadモジュールとMediaモジュールでフィールドのラベルとして表示されます。表示名に基づいて、フィールドの内部名が自動的に作成されます。

    6. フィールドの [ タイプ ] を選択します。
      • テキスト -ユーザーは、1024文字までのシングルバイト文字（または全角512文字）までフィールドに入力できます。
      • リスト -ユーザーは値のリストから選択します。リストには最大150個の値を指定することができ、リスト内の各値の長さは最大100文字以内です。
    7. 「説明」を入力します。説明フィールドは、Studioのインターフェイスにヒントとして表示されます。
    8. カスタムフィールドを必須にする場合は、[ このフィールドを必須にする] をチェックします。

    9. フィールドタイプが [ リスト ] の場合、以下のスクリーンショットのように、カンマで区切られた値のリストを入力し、[リストに追加] をクリックします。

    10. [ フィールドの保存 ] をクリックして、変更を保存します。[ 保存してさらに追加 ] をクリックしてフィールドを保存し、別のフィールドの作成を開始します。

     作成したカスタムフィールドはすぐに使用でき、Media  モジュールに表示されます。

    最大 10 個のカスタムフィールドを作成できます。10 個を超えるフィールドが必要な場合は、[さらにフィールドが必要ですか？] リンクをクリックして、Brightcoveのカスタマーサポートにお問い合わせください。パブリッシャーのカスタムフィールドの上限は 50 個です。

    リスト値の編集

    リストタイプのフィールドに値を追加できます。カスタムフィールド名のリンクをクリックし、値を追加して、 [リストに追加] をクリックします。完了したら、[ フィールドの保存 ] をクリックします。

    リスト値の削除

    リストタイプのカスタムフィールドから既存の値を削除することができます。カスタムフィールド名のリンクをクリックし、値に関連づけられた削除アイコン（）をクリックしてから、フィールドを保存 をクリックします。

    リストの値が削除されると、その値が以前に割り当てられていた動画は、その値を保持します。ただし、削除された値を持つビデオを編集すると、値はクリアされ、新しい値を選択する必要があります。

    アカウントからのカスタムフィールドの削除

    アカウントからカスタム項目を削除するには、 Brightcove サポートにお問い合わせください。Brightcove サポートでカスタム項目を削除した場合、値が存在していた動画では変更日が変更されます。

    Brightcoveの Beacon メタデータにリスト値を使用する

    下の表には、作成しなければならないカスタムフィールドがいくつかあります。上記のように、カスタムフィールドを作成する際には、データタイプを [ テキスト ] または [ リスト ] のいずれかに選択します。タイプはすべてテキストであることに注意してください。動画コンテンツのキュレーターがテキストを入力するのではなく、リストから選択できるようにすると、負担が軽減されるかもしれません。また、値を入力するのではなく、リストから選択した方が、データ入力の一貫性が保たれます。したがって、ビジネスケースによっては リスト が有効であれば、リストを使用できます。

    もちろん、選択するのはお客様自身ですが、カスタムフィールドによっては、データタイプにリスト が良い選択である場合があります。。たとえば、リストには以下のようなものがあります。

    • beacon.genre
    • beacon.agerating
    • Beacon.viewersCore
    • beacon.rights.<counter>.type

    標準フィールド

    次の表に、標準の Video Cloud フィールドを示します。このフィールドは、デフォルトで存在し、メタデータが関連付けられている動画を適切にインポートするために Brightcove Beacon によって使用されます。

    上記の手順6から文字制限について思い出して下さい：

    • テキスト：1024文字までのシングルバイト文字（または全角文字 512 文字）を含めることができます。
    • リスト:指定できる値は 150 個以下で、リスト内の各値は 100 文字以下です。
    Video Cloudフィールド 説明 どこで/どのように
    生成されたか     		必須
    duration Brightcove Beacon によって使用され、詳細画面に視聴率と再生時間が表示されます。 Video Cloudによる自動入力 はい
    images.poster.src 横長画像 (16:9):
    最小 幅:1000px 高さ:563px
    最大 幅:4000px 高さ:2250px
    		動画プロパティの画像→ポスターセクションを開き、ローカルに保存された画像の場所を参照します。 はい
    images.thumbnail.src 縦長画像 (2:3)
    最小 幅:1000px 高さ:1500px
    最大 幅:2000px 高さ:3000px
    		動画のプロパティの画像→サムネイルセクションを開き、ローカルに保存された画像の場所を参照します。 はい
    images.WideBanner.src 近日公開 -その間デフォルトはimages.poster.src
    images.portritPoster.src 近日公開 -その間デフォルトはimages.poster.src
    name アセットのタイトルとしてBrightcove Beaconで使用されます。 動画のプロパティの動画情報のセクションを編集し、名前を入力します。 はい
    タグ アプリケーションには表示されませんが、プレイリストを作成するために Brightcove Beacon によって使用されます 動画プロパティの動画情報のセクションを編集し、タグ を入力します。 いいえ

    カスタムフィールド名

    このドキュメントの次の 3 つのセクションでは、特定の実装ユースケースに基づいて作成する必要があるカスタムフィールドについて説明します。各カスタムフィールドには、[ 表示名] と [ 内部名 ] の両方があります。もし、表示名オプションにもっと意味のある名前があれば、それを使うことができますが、内部名完全に一致しなければなりません。

    一般的なカスタムフィールド

    次の表は、実装に応じて作成する必要があるVideo Cloud のカスタムフィールドです。[ このフィールドを必須にする] チェックボックスをオンにする必要がないことに注意してください。

    表示名 内部名 タイプ 注意/例
    beacon.genre beacon_genre テキスト *アセットのジャンル
    *詳細ページに表示され、さまざまな画面でアセットを整理するために使用されます。この値が設定されていない場合は、ユーザーインターフェイスにNo Genreと表示されます。
    *この値を設定しないと、関連性のあるコンテンツ機能にに影響を与えます。
    * 例：Brightcoe Beacon で定義されているジャンルの1つ、例： ムービーのアクション または アドベンチャー など。
    beacon.
    productionYear    		 beacon_
    prductionyear     		テキスト *動画アセットの制作年-詳細ページに表示されます
    * 4桁の整数
    beacon.cast
    director     		beacon_cast_
    director     		テキスト *コンマ区切りの監督名リスト
    * 例：監督の名前、例： ジェーン・スミス、サンティアゴ・アルマダ
    beacon.cast.singer cast_singer テキスト *コンマ区切りの歌手名のリスト
    * 例：歌手の名前、例： ジェーン・スミス、サンティアゴ・アルマダ
    beacon.cast.actor cast_actor テキスト *コンマ区切りの俳優名
    * 例：俳優の名前、例： ジェーン・スミス、サンティアゴ・アルマダ
    beacon.cast.
    composer     		beacon_cast_
    composer     		テキスト *コンマ区切りの作曲家名
    * 例：作曲家の名前、例： ジェーン・スミス、サンティアゴ・アルマダ
    beacon.cast.
    songWriter     		beacon_cast_
    songwriter     		テキスト *コンマ区切りの作詞家名
    * 例：作詞家の名前、例： ジェーン・スミス、サンティアゴ・アルマダ
    beacon.cast.writer cast_writer テキスト *コンマ区切りの作家名
    * 例：作家の名前、例： ジェーン・スミス、サンティアゴ・アルマダ
    beacon.agerating beacon_agerating テキスト *アセットに対する年齢レーティングを提供します
    *このフィールドの値は、カンマで区切られたkey = valueのペア形式である必要があり、キーは国コードです（usなど）、値はBrightcove Beaconがサポートする国コードに適した年齢レーティングです。
    *この値が設定されていない場合、Brightcove Beaconで設定されているデフォルトの国の年齢レーティングシステムの最も許容度の高いレーティングが使用されます
    *例：key = value、key = value、例： us = TV-Y、us = TV-M)
    beacon.
    shortDescription     		beacon _
    shortdescription     		テキスト * Brightcove Beacon用に合わせた簡単な説明を入力できます。
    *この値が設定されていない場合は、ビデオの簡単な説明フィールドに設定されたテキストが使用されます
    *このフィールドを空白のままで、Video Cloud Studioの動画情報の短い説明 が入力されている場合、Studioの値が取り込まれます。Studioの短い説明 は、250 文字に制限されていますが、このカスタムフィールドには 1024 文字まで入力できます。
    beacon.
    longDescription     		beacon_
    longdescription     		テキスト * Brightcove Beacon用に合わせた長い説明を入力できます。
    *この値が設定されていない場合、動画の長い説明フィールドに設定されたテキストが使用されます。
    *このフィールドを空白のままにすると、Video Cloud Studioの動画情報に動画の長い説明 が入力されている場合、Studioの値が取り込まれます。Studioの長い説明 は、5000 文字ですが、このカスタムフィールドには 1024 文字しか指定できません。
    beacon.
    ViewerScore     		Beacon_
    viewerscore     		テキスト *視聴者スコアは、ユーザーがコンテンツを評価した場合、ユーザーの評価を示し、そうでない場合は、そのコンテンツに対する全ユーザーの平均評価を示します。
    *可能な値は0〜100の整数です
    beacon.trailer.id beacon_trailer_id テキスト *このフィールドが設定されているアセットの予告編として使用されるVideo Cloud内の別のビデオアセットを指します
    *指定されたアセットはムービーまたはエピソードとして破棄されます
    * 例：Video CloudビデオID、例： 6140603191001
    beacon.ingest beacon_ingest テキスト *このフィールドがない場合、デフォルトでインジェストされます。
    *特定のアセットをBrightcove Beaconと同期させたくない場合は、No に設定します。

    権利管理のフィールド

    アセットの収益化とアクセス制限をサポートするには、カスタムフィールドのセットを使用する必要があります。アクセス権管理構成は、複数のインスタンスを持つことができるため、カスタムフィールドのセットを複数作成することをお勧めします。各インスタンスの名前には、カウンタを使用してそれらを区別します。最初のインスタンスは 0 へのカウンタを使用する必要があります。以下は、実際にカウンタ値を使用しているこれらのグループ化されたフィールドの例です。

    たとえば、動画で使用する広告を定義するセットと、新年のような祝日の特別企画を定義するためのセットが必要な場合があります。

    具体的な例を挙げて、これらのフィールドの使用方法を説明します。次のスクリーンショットは、Video Cloud の動画で使用するサーバーサイド広告挿入（SSAI）の設定を示しています。

    この例では、次のことを学べます。

    • グループ内のすべての権利管理フィールドに値を割り当てる必要がありません。この場合、 beacon.rights.<counter>.adConfiguration と beacon.rights.<counter>.type だけが使用されます。
    • Studio で作成された SSAI設定 ID は、Brightcove Beacon のカスタムフィールドで使用できます。
    • 権利管理フィールドのセットに対するカウンタ値は 0 (黄色で強調表示) から開始できます。
    • このスクリーンショットでは直接見えませんが、事実ですが、Video Cloud SSAI の設定は Brightcove Beacon に取り込まれます。

    作成するどのフィールドも、[ このフィールドを必須にする] チェックボックスをオンにする必要がないことに注意してください。

    次の表に、実装に応じて作成する必要がある Video Cloud のカスタムフィールドを示しています。

    表示名 内部名 タイプ 注意/例
    beacon.rights.<counter>.type beacon_rights_
    <counter>_type    		 テキスト *動画アセットの収益化のタイプを特定します
    *値には、次のいずれかを使用します。
    • FREE
    • AVOD
    • SVOD
    • INHERIT
    * デフォルト値:FREE
    * INHERIT値は エピソード アセットのみに適用されます。
    beacon.rights.
    <counter>.
    startDate     		beacon_rights_
    <counter> _
    startdate     		テキスト *この特定のセットにおけるアクセス制限および収益化オプションの下で動画アセットが公開されるべき日付
    * フォーマット：日付yyyy-mm-dd hh：mm：ss
    * デフォルト値:設定されていない場合、デフォルトは動画公開開始日
    beacon.rights.<counter>.endDate beacon_rights_
    <counter> _enddate     		テキスト *この特定のセットにおけるアクセス制限および収益化オプションの下で動画資産が公開されなくなるべき日付
    * フォーマット：日付yyyy-mm-dd　hh：mm：ss
    * デフォルト値:設定されていない場合、動画の公開終了日がデフォルトになります。
    beacon.rights.<counter>.devices beacon_rights_
    <counter>_devices     		テキスト *この特定のセットにおけるアクセス制限と収益化オプションの下で動画アセットが公開されるべき、Brightcove Beacon でサポートされているデバイスのコンマ区切りリスト
    *カンマ区切りのリスト：
    • iOS
    • Android
    • Web
    • Roku
    • STV
    • Fire TV
    • Samsung
    • appletv
    • androidtv
    * デフォルト値:設定されていない場合、デフォルトはBrightcove Beacon でサポートされているすべてのデバイスになります
    beacon.rights.
    <counter>.
    locationPermit     		beacon_rights_
    <counter> _
    locationspermit     		テキスト *この特定のセットにおけるアクセス制限と収益化オプションの下で動画アセットが公開されるべき、Brightcove Beacon で定義された場所のコンマ区切りリスト
    * デフォルト値:設定されていない場合、デフォルトでBrightcove Beacon でサポートされているすべての場所になります
    beacon.rights.<counter>。
    locationsDeny     		beacon_rights_
    <counter> _
    locationsdeny     		テキスト *この特定のセットにおけるアクセス制限と収益化オプションの下で動画アセットが公開されるべきではないBrightcove Beacon で定義された場所のコンマ区切りリスト
    *デフォルト値なし
    beacon.rights.
    <counter>。
    packageName     		beacon_rights_
    <counter> _
    packagename     		テキスト *このフィールドの値は、 beacon.rights.<counter>.typeフィールドの値がSVODに設定されている場合に入力しなければならない。
    * Brightcove Beaconで定義されている、パッケージ名のコンマ区切りリスト
    *例： プレミアムスポーツ、アクション映画、アースデイ映画
    *デフォルト値なし
    beacon.rights.
    <counter>.
    adConfiguration     		beacon_rights_
    <counter> _
    adconfiguration     		テキスト *このフィールドの値は、 Beacon.rights.<counter>.typeフィールドの値がAVODに設定されている場合に入力しなければ張りません
    * Brightcove Beaconの広告構成の識別子
    *デフォルト値なし

    エピソード フィールド

    シリーズのエピソードである動画については、以下を完了する必要があります。次の図は、シリーズとシーズンとエピソードの関係を示しています。

    この図に基づくと、シリーズの6つの動画に必要なフィールドは次のとおりです。

    • 動画1
      • beacon.episode.serieName:オレゴン コーストの冒険
      • beacon.episode.seasonNumber:1
      • beacon.episode.number:1
    • 動画2
      • beacon.episode.serieName:オレゴン コーストの冒険
      • beacon.episode.seasonNumber:1
      • beacon.episode.number:2
    • 動画3
      • beacon.episode.serieName:オレゴン コーストの冒険
      • beacon.episode.seasonNumber:1
      • beacon.episode.number:3
    • 動画4
      • beacon.episode.serieName:オレゴン コーストの冒険
      • beacon.episode.seasonNumber:2
      • beacon.episode.number:1
    • 動画5
      • beacon.episode.serieName:オレゴン コーストの冒険
      • beacon.episode.seasonNumber:2
      • beacon.episode.number:2
    • 動画6
      • beacon.episode.serieName:オレゴン コーストの冒険
      • beacon.episode.seasonNumber:2
      • beacon.episode.number:3

    ここでは、エピソードフィールドを使用する実際の実装を示します。この場合、カスタムフィールドは、関連する値（黄色で強調表示された値）とともに表示されます。

    表示名 内部名 タイプ 注意/例
    beacon.episode.
    serieName     		beacon_episode_
    seriename     		テキスト *エピソード アセットである場合、このフィールドに値を入力する必要があります。
    *値は、エピソードが属するBrightcove Beacon のシリーズ識別子を指します（シリーズはBrightcove Beacon で直接作成する必要があります）
    * 例：シリーズ名、 オレゴン コーストの冒険
    beacon.episode.
    seasonNumber     		beacon_episode_
    seasonnumber     		テスト *エピソード アセットである場合は、このフィールドに値を入力する必要があります。
    *エピソードが属するBrightcove Beaconのシーズン番号を識別します（シーズンはBrightcove Beaconで直接作成する必要があります）
    * フォーマット：動画が属するシーズン番号を示す整数値
    beacon.episode.
    number     		beacon_episode_
    number     		テキスト *エピソード アセットの場合は、このフィールドに値を入力する必要があります。
    *シーズン内のエピソード番号を示します。
    * フォーマット：動画のエピソード番号を示す整数値
    ページの最終更新日27 Jun 2025