LiveEventBuilder
LiveEventオブジェクトのインスタンスを作成するビルダー。
拡張
コンストラクタ
new LiveEventBuilder()
new LiveEventBuilder():
LiveEventBuilder
戻り値
継承元
メソッド
attributes()
attributes(
attributes):LiveEventBuilder
ライブイベントの属性をライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
attributes
string[]
ライブイベントのプロパティ。このフィールドで推奨される標準値のリストについては、開発者ガイドを参照してください。このフィールドは任意ですが、わかっている場合は必ず入力する必要があります。リストの最大サイズは32です。アイテムが32個を超える場合、余分なアイテムは削除されます。各項目の最大サイズは255バイトです。この長さを超える項目は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
attributesが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
build()
build():
ILiveEvent
指定されたパラメーターからLiveEventオブジェクトをビルドします。
戻り値
ビルドされたLiveEventオブジェクト。
詳細
この関数は、他のビルダー関数を使用してライブイベントビルダーの目的のフィールドを設定した後に、呼び出す必要があります。build() 関数は、ビルダーオブジェクトごとに1回だけ呼び出す必要があります。
スロー
必須フィールドが1つ以上欠落している場合に発生します。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
オーバーライド
description()
description(
description):LiveEventBuilder
ライブイベントビルダーでライブイベントの説明を設定し、ビルダーのインスタンスを返します。
パラメーター
説明
string
ライブイベントの簡単な説明。このフィールドは省略可能です。文字列の長さが8192バイトを超えると文字列は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
descriptionが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
endTimeMs()
endTimeMs(
endTimeMs):LiveEventBuilder
ライブイベントの終了時刻をライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
endTimeMs
number
ライブイベントの終了時刻（エポックミリ秒単位）。このフィールドは、過去または将来の値を表すことができます。eventTypeがSCHEDULED_EVENTの場合、このフィールドは必須です。
戻り値
endTimeMsが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
eventType()
eventType(
eventType):LiveEventBuilder
ライブイベントのタイプをライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
eventType
ライブイベントのタイプ。このフィールドは必須です。
戻り値
eventTypeが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
genres()
genres(
genres):LiveEventBuilder
ライブイベントのジャンルをライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
genres
string[]
ライブイベントに適用されるジャンルのリスト。このフィールドで推奨される標準値のリストについては、開発者ガイドを参照してください。ジャンルを指定するかどうかは任意ですが、わかっている場合は必ず提供する必要があります。リストの最大サイズは32です。アイテムが32個を超える場合、余分なアイテムは削除されます。各項目の最大サイズは255バイトです。この長さを超える項目は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
genresが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
identifier()
identifier(
identifier):LiveEventBuilder
ライブイベントビルダーでライブイベントの一意の識別子を設定し、ビルダーのインスタンスを返します。
パラメーター
identifier
string
特定のライブイベントの一意の識別子。この識別子は、アプリケーションパッケージ内のすべてのライブイベントで一意である必要があります。特定のライブイベントの更新時に、この識別子は変更しないでください。このフィールドは必須で、最大長は8192バイトです。
戻り値
identifierが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
フィールドが最大長の8192バイトを超える場合発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
logoUrl()
logoUrl(
logoUrl):LiveEventBuilder
ライブイベントのロゴURLをライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
logoUrl
string
ライブイベントのロゴが表示されるURL。このフィールドは省略可能です。このフィールドの最大長は8192バイトです。
戻り値
logoUrlが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
フィールドが最大長の8192バイトを超える場合発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
playbackReference()
playbackReference(
playbackReference):LiveEventBuilder
ライブイベントビルダーでライブイベントの再生リファレンスを設定し、ビルダーのインスタンスを返します。
パラメーター
playbackReference
ライブイベントの再生リファレンス。再生を開始する方法が記述されています。このフィールドは必須です。
戻り値
playbackReferenceが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
posterArtUrl()
posterArtUrl(
posterArtUrl):LiveEventBuilder
ライブイベントビルダーでライブイベントのポスターアートURLを設定し、ビルダーのインスタンスを返します。
パラメーター
posterArtUrl
string
ポスターアート画像が表示されるURL。このフィールドは省略可能です。このフィールドの最大長は8192バイトです。
戻り値
posterArtUrlが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
フィールドが最大長の8192バイトを超える場合発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
ratings()
ratings(
ratings):LiveEventBuilder
ライブイベントのレーティングをライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
ratings
string[]
特定のライブイベントで推奨される保護者による指導レベルを示すために使用される文字列のリスト。ライブイベントが放送される国や地域で使用されている任意のレーティングシステムに従うことができます。保護者による指導のレーティングを指定するかどうかは任意ですが、わかっている場合は必ず提供する必要があります。このフィールドで推奨される標準値のリストについては、開発者ガイドを参照してください。リストの最大サイズは32です。アイテムが32個を超える場合、余分なアイテムは削除されます。各項目の最大サイズは255バイトです。この長さを超える項目は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
ratingsが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
sortRank()
sortRank(
sortRank):LiveEventBuilder
ライブイベントビルダーのライブイベントの並べ替えランクを設定し、ビルダーのインスタンスを返すオプションの関数。
パラメーター
sortRank
number
このライブイベントを他のライブイベントと比較した場合の並べ替えランク。
戻り値
並べ替えランクが設定されたLiveEventBuilderオブジェクト。
詳細
このアプリの行では、並べ替えランクの整数値が小さいライブイベントが、並べ替えランクの値が大きいライブイベントよりも前に表示されます。指定しない場合、このフィールドはデフォルトでMAX Int32に設定されます。並べ替えランクが同じライブイベントが複数ある場合は、タイトルのアルファベット順に並べられます。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
startTimeMs()
startTimeMs(
startTimeMs):LiveEventBuilder
ライブイベントの開始時刻をライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
startTimeMs
number
ライブイベントの開始時刻（エポックミリ秒単位）。このフィールドは、過去または将来の値を表すことができます。eventTypeがSCHEDULED_EVENTの場合、このフィールドは必須です。
戻り値
startTimeMsが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
title()
title(
title):LiveEventBuilder
ライブイベントのタイトルをライブイベントビルダーで設定し、ビルダーのインスタンスを返します。
パラメーター
title
string
ライブイベントのタイトル。このフィールドは必須です。文字列の長さが255バイトを超えると文字列は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
titleが設定されたLiveEventBuilderオブジェクト。
スロー
このビルダーインスタンスが既に1回オブジェクトをビルドした後に関数が呼び出された場合に発生します。
スロー
有効なUTF-8ではない文字列が渡された場合に発生します。
Last updated: 2025年9月30日
