com.nttdocomo.system
クラス DTVScheduleParam

Object
  拡張com.nttdocomo.system.DTVScheduleParam

public final class DTVScheduleParam
extends Object
 [iアプリオプションAPI]

デジタルテレビ予約スケジュールの新規登録用のパラメータを定義します。

予約スケジュールを新規に登録するためには、 コンストラクタにより DTVScheduleParam オブジェクトを生成します。 生成したオブジェクトには物理チャンネル等を設定することができます。

登録は DTVSchedule.addEntry(int, DTVScheduleParam) メソッドで行います。 登録時の動作の詳細は、メソッドの説明を参照して下さい。

導入されたバージョン:
DoJa-5.0 (903iTV)、DoJa-5.1 (905i)
関連項目:
DTVSchedule

コンストラクタの概要
DTVScheduleParam()
          新規登録用に予約スケジュールパラメータを生成します。
 
メソッドの概要
 void setAffiliationId(int affiliationId)
          系列識別を設定します。
 void setEndTime(java.util.Calendar endTime)
          番組終了時刻を設定します。
 void setEventName(String eventName)
          番組名を設定します。
 void setFrequency(int frequency)
          物理チャンネルを設定します。
 void setRepeatType(int type)
          繰り返しタイプを設定します。
 void setServiceId(int serviceId)
          サービス識別を設定します。
 void setServiceName(String serviceName)
          チャンネル名を設定します。
 void setStartTime(java.util.Calendar startTime)
          番組開始時刻を設定します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

DTVScheduleParam

public DTVScheduleParam()
新規登録用に予約スケジュールパラメータを生成します。

初期状態は以下のようになります。

例外:
UnsupportedOperationException - [DoJa-5.1 (905i) 以降] 端末がデジタルテレビ機能をサポートしていない場合に発生します。
UnsupportedOperationException - [DoJa-5.1 (905i) 以降] デジタルテレビ機能はサポートしていても、 視聴/録画予約スケジューラ機能をサポートしていない場合に発生します。
メソッドの詳細

setFrequency

public void setFrequency(int frequency)
物理チャンネルを設定します。

パラメータ:
frequency - 物理チャンネルを指定します。 13 以上 62 以下の値を指定できます。 物理チャンネルを指定したくない場合は DTVSchedule.FREQUENCY_NONE を指定します。
例外:
IllegalArgumentException - 引数 frequency に 13 より小さい値、または 62 より大きい値が指定された場合に発生します。 ただし、-1 が指定された場合には発生しません。

setServiceId

public void setServiceId(int serviceId)
サービス識別を設定します。

パラメータ:
serviceId - サービス識別を指定します。 0 以上 216 -1 以下の値を指定できます。 サービス識別を指定したくない場合は DTVSchedule.SERVICE_ID_NONE を指定します。
例外:
IllegalArgumentException - 引数 serviceId に -1 より小さい値、 または 216 -1 より大きい値が指定された場合に発生します。

setAffiliationId

public void setAffiliationId(int affiliationId)
系列識別を設定します。

パラメータ:
affiliationId - 系列識別を指定します。 0 以上 11 以下の値を指定できます。 系列識別を指定したくない場合は DTVSchedule.AFFILIATION_ID_NONE を指定します。
例外:
IllegalArgumentException - 引数 affiliationId に -1 より小さい値、 または 11 より大きい値が指定された場合に発生します。

setServiceName

public void setServiceName(String serviceName)
チャンネル名を設定します。

パラメータ:
serviceName - チャンネル名(通常文字列)を指定します。 null を指定可能です。

setStartTime

public void setStartTime(java.util.Calendar startTime)
番組開始時刻を設定します。

パラメータ:
startTime - 番組開始時刻を指定します。 null を指定可能です。
例外:
IllegalArgumentException - 引数 startTime にシステムが提供している以外のオブジェクト (Calendar クラスを継承した未知のクラスのオブジェクト) が渡された場合に発生します。

setEndTime

public void setEndTime(java.util.Calendar endTime)
番組終了時刻を設定します。

パラメータ:
endTime - 番組終了時刻の時間を指定します。 null を指定可能です。
例外:
IllegalArgumentException - 引数 endTime にシステムが提供している以外のオブジェクト (Calendar クラスを継承した未知のクラスのオブジェクト) が渡された場合に発生します。

setRepeatType

public void setRepeatType(int type)
繰り返しタイプを設定します。

引数 type には ScheduleDate クラスに定義されているスケジュール時刻タイプ(日時指定タイプ)を指定します。

パラメータ:
type - 繰り返しタイプを指定します。 ScheduleDate.ONETIMEScheduleDate.DAILYScheduleDate.WEEKLYScheduleDate.MONTHLYScheduleDate.YEARLY のいずれかを指定します。
例外:
IllegalArgumentException - 引数 type に不正な値を指定した場合に発生します。

setEventName

public void setEventName(String eventName)
番組名を設定します。

パラメータ:
eventName - 番組名を指定します。 null を指定可能です。


NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ(その他に許諾者がある場合は当該許諾者も含めて)の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「iモード」、「iアプリ/アイアプリ」、「i-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。