com.docomostar.device
クラス IrRemoteControl

Object
  com.docomostar.device.IrRemoteControl

public class IrRemoteControl
extends Object

IRリモートコントローラ機能を提供します。 アプリケーションは getIrRemoteControl メソッドを利用して IrRemoteControl クラスのただ1つのインスタンスを持つことができます。 設定されたキャリア、論理パルス情報は赤外線の通信中か否かによらず、 その後の send メソッド呼び出し時に利用されます。

導入されたバージョン:

Star-1.0

関連項目:

IrRemoteControlFrame

フィールドの概要

static int	PATTERN_HL コードの出力パターンがHigh 先行を表します(=0)。
static int	PATTERN_LH コードの出力パターンがLow 先行を表します(=1)。

コンストラクタの概要

protected

IrRemoteControl() アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの概要

static IrRemoteControl	getIrRemoteControl() IR リモートコントローラオブジェクトを取得します。
void	send(int numFrames, IrRemoteControlFrame[] frames) デフォルトのタイムアウト値(10sec)で信号を送信します。
void	send(int numFrames, IrRemoteControlFrame[] frames, int timeout) タイムアウト値を指定して信号を送信します。
void	send(int numFrames, IrRemoteControlFrame[] frames, int timeout, int count) タイムアウト値、送信する回数を指定して信号を送信します。
void	setCarrier(int highDuration, int lowDuration) キャリア情報を設定します。
void	setCode0(int pattern, int highDuration, int lowDuration) 論理0パルス情報を設定します。
void	setCode1(int pattern, int highDuration, int lowDuration) 論理1パルス情報を設定します。
void	stop() Ir 信号の送信を停止します。

クラス Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

PATTERN_HL

public static final int PATTERN_HL

コードの出力パターンがHigh 先行を表します(=0)。

関連項目:

定数フィールド値

PATTERN_LH

public static final int PATTERN_LH

コードの出力パターンがLow 先行を表します(=1)。

関連項目:

定数フィールド値

コンストラクタの詳細

IrRemoteControl

protected IrRemoteControl()

アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの詳細

getIrRemoteControl

public static IrRemoteControl getIrRemoteControl()

IR リモートコントローラオブジェクトを取得します。

戻り値:

IR リモートコントローラオブジェクトを返します。

例外:

UnsupportedOperationException -
(ミニアプリ実行時のみ) IR リモートコントローラ機能をサポートしていない場合に発生します。 この例外はフルアプリ実行時には発生しません。

send

public void send(int numFrames,
                 IrRemoteControlFrame[] frames,
                 int timeout)

タイムアウト値を指定して信号を送信します。 numFrames 値によって指定された数のフレームデータを送信します。 指定された数の全てのフレームデータの送信が終了した場合には タイムアウトする、stop メソッドが呼ばれる、又はその他の条件 により送信が中断されるまで最初のフレームから送信を繰り返します。 あるフレームの送信回数が無限回に指定されている場合には それ以降のフレームは送信されません。 このメソッドは非同期に実行され、ブロックしません。

パラメータ:

numFrames - 送信データのフレーム数(1以上)を指定します。

frames - 送信データフレームの配列を指定します。

timeout - タイムアウト値(sec)を指定します。

例外:

IllegalStateException -
ミニアプリ実行時の Focused または Unfocused 状態で呼び出された場合に発生します。

NullPointerException -
frames が null の場合に発生します。

IllegalArgumentException -
timeout 値が範囲外の場合に発生します。

ArrayIndexOutOfBoundsException -
numFrames 値が0以下の場合に発生します。

NullPointerException -
frames が null ではなく、配列の要素中に null が設定されている場合に発生します。

ArrayIndexOutOfBoundsException -
引数 frames に含まれるフレーム数が numFrames 未満の場合に発生します。

IllegalArgumentException -
設定されたキャリア情報が不正な場合に発生します。

IllegalArgumentException -
設定されたパルス情報が不正な場合に発生します。

IllegalArgumentException -
設定されたフレーム情報が不正な場合に発生します。 引数 frames に設定されているフレームリピート時間が、 フレームデータを送信するのに必要な時間より少ない場合や、 引数 frames に設定されているいずれかの要素に、 未設定のパラメータが存在する IrRemoteControlFrame オブジェクトが存在する場合も含みます。

SecurityException -
端末がセルフモードの場合に発生します。

DeviceException -
(BUSY_RESOURCE)
ネイティブ側で既に赤外線送信中の場合に発生します(OBEX 通信も含む)。

DeviceException -
(RACE_CONDITION)
アドホック通信中の場合に発生します。

DeviceException -
(RACE_CONDITION)
パケット通信中の場合に発生します。 以下の場合にも発生します。

• メール着信動作中の場合
• リモート制御によるパケット通信中の場合
• ミュージックチャネルダウンローダが起動中の場合
• ソフトウェア更新のダウンロード通知機能が起動中の場合
• [Star-1.1 まで] PTT 呼通信中、PTT 設定中の場合

DeviceException -
(RACE_CONDITION)
音声・テレビ電話通話中の場合に発生します。

DeviceException -
(RACE_CONDITION)
測位中である場合に発生します。 LocationProvider.setTrackingListener(TrackingListener listener, int interval, int timeout) の引数 listener に、null 以外が設定されている場合も含みます。

DeviceException -
(RACE_CONDITION)
Bluetooth と赤外線通信の同時使用をサポートしていない端末において、 Bluetooth 通信中の場合に発生します。

send

public void send(int numFrames,
                 IrRemoteControlFrame[] frames)

デフォルトのタイムアウト値(10sec)で信号を送信します。 numFrames 値によって指定された数のフレームデータを送信します。 指定された数の全てのフレームデータの送信が終了した場合には タイムアウトする、stop メソッドが呼ばれる、又はその他の条件 により送信が中断されるまで最初のフレームから送信を繰り返します。 あるフレームの送信回数が無限回に指定されている場合には それ以降のフレームは送信されません。 このメソッドは非同期に実行され、ブロックしません。

パラメータ:

numFrames - 送信データのフレーム数(1以上)を指定します。

frames - 送信データフレームの配列を指定します。

例外:

IllegalStateException -
ミニアプリ実行時の Focused または Unfocused 状態で呼び出された場合に発生します。

NullPointerException -
frames が null の場合に発生します。

ArrayIndexOutOfBoundsException -
numFrames 値が0以下の場合に発生します。

NullPointerException -
frames が null ではなく、 配列の要素中に null が設定されている場合に発生します。

ArrayIndexOutOfBoundsException -
frames に含まれるフレーム数がnumFrames未満の場合に発生します。

IllegalArgumentException -
設定されたキャリア情報が不正な場合に発生します。

IllegalArgumentException -
設定されたパルス情報が不正な場合に発生します。

IllegalArgumentException -
設定されたフレーム情報が不正な場合に発生します。 引数 frames に設定されているフレームリピート時間が、 フレームデータを送信するのに必要な時間より少ない場合や、 引数 frames に設定されているいずれかの要素に、 未設定のパラメータが存在する IrRemoteControlFrame オブジェクトが存在する場合も含みます。

SecurityException -
端末がセルフモードの場合に発生します。