com.j_phone.io
インタフェース TelevisionConnection

すべてのスーパーインタフェース:
javax.microedition.io.Connection

public interface TelevisionConnection
extends javax.microedition.io.Connection

TV機能を実現するためのインタフェースです。

このインタフェースを実装したオブジェクトは、スキームに "television:" を指定してConnector.open()メソッドを呼び出すことで取得できます。 TV機能をサポートしていない機器の場合、 Connector.open()メソッド呼び出したときにIOExceptionが発生します。 TV機能は、close()メソッドを呼び出すことで終了します。

導入されたバージョン:
JSCL 1.3.2

フィールドの概要
static int CATV
          チャンネル種別:CATVを示します。
static int GROUND_WAVE_ANALOG
          チャンネル種別:地上波アナログ(VHF/UHF)を示します。
static int STATE_IMPOSSIBLE
          起動可否状態:その他の理由で起動不可であることを示します。
static int STATE_LITTLE_BATTERY
          起動可否状態:バッテリー残量少のため起動不可であることを示します。
static int STATE_READY
          起動可否状態:起動可能であることを示します。
static int STATE_TV_OFF
          起動可否状態:TV 視聴設定OFFのため起動不可であることを示します。
static int STATE_UNSUPPORTED
          起動可否状態:チャンネル種別非サポートのため起動不可であることを示します。
 
メソッドの概要
 void activate(int category, int channel)
          チャンネルを指定してTVを起動します。
 int getAreaInfo()
          エリア情報を取得します。
 int getLastCategory()
          最後に設定されたチャンネル種別を取得します。
 int getLastChannel()
          最後に設定されたチャンネルを取得します。
 int getState(int category)
          起動可否状態を取得します。
 
インタフェース javax.microedition.io.Connection から継承したメソッド
close
 

フィールドの詳細

GROUND_WAVE_ANALOG

public static final int GROUND_WAVE_ANALOG
チャンネル種別:地上波アナログ(VHF/UHF)を示します。

チャンネル番号の有効範囲は 1 〜 62 です。


CATV

public static final int CATV
チャンネル種別:CATVを示します。

チャンネル番号の有効範囲は 13 〜 63 です。


STATE_READY

public static final int STATE_READY
起動可否状態:起動可能であることを示します。

STATE_UNSUPPORTED

public static final int STATE_UNSUPPORTED
起動可否状態:チャンネル種別非サポートのため起動不可であることを示します。

STATE_LITTLE_BATTERY

public static final int STATE_LITTLE_BATTERY
起動可否状態:バッテリー残量少のため起動不可であることを示します。

STATE_TV_OFF

public static final int STATE_TV_OFF
起動可否状態:TV 視聴設定OFFのため起動不可であることを示します。

STATE_IMPOSSIBLE

public static final int STATE_IMPOSSIBLE
起動可否状態:その他の理由で起動不可であることを示します。
メソッドの詳細

getState

public int getState(int category)
起動可否状態を取得します。
パラメータ:
category - チャンネル種別
戻り値:
起動可否状態。以下のどれかが返ります。
例外:
java.lang.IllegalArgumentException - 不正な引数が指定された場合に発生する

activate

public void activate(int category,
                     int channel)
              throws java.io.IOException
チャンネルを指定してTVを起動します。
パラメータ:
category - チャンネル種別
channel - チャンネル
例外:
java.lang.IllegalArgumentException - 不正な引数が指定された場合に発生する
java.io.IOException - TV起動に失敗した場合に発生する

getLastCategory

public int getLastCategory()
最後に設定されたチャンネル種別を取得します。
戻り値:
チャンネル種別

getLastChannel

public int getLastChannel()
最後に設定されたチャンネルを取得します。
戻り値:
チャンネル

getAreaInfo

public int getAreaInfo()
エリア情報を取得します。

エリア情報の詳細は、共通コード表を参照してください。 共通コード表にない設定、電波状況による自動設定をサポートする機器端末の場合、 都道府県・地域コードは「00」になります。

戻り値:
エリア情報。 4桁の整数(上位2桁:都道府県コード、下位2桁:地域コード)。