com.nttdocomo.device
クラス IrRemoteControl

Object
  拡張com.nttdocomo.device.IrRemoteControl

public class IrRemoteControl
extends Object

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

導入されたバージョン:
DoJa-3.0 (505i)
関連項目:
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 リモートコントローラオブジェクトを返します。

send

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

パラメータ:
numFrames - 送信データのフレーム数(1以上)を指定します。
frames - 送信データフレームの配列を指定します。
timeout - タイムアウト値(sec)を指定します。
例外:
IllegalStateException - 送信するアプリケーションが待ち受け非活性状態の場合に発生します。
NullPointerException - frames が null の場合に発生します。
IllegalArgumentException - timeout 値が範囲外の場合に発生します。
ArrayIndexOutOfBoundsException - numFrames 値が0以下の場合に発生します。
NullPointerException - frames が null ではなく、配列の要素中に null が設定されている場合に発生します。
ArrayIndexOutOfBoundsException - 引数 frames に含まれるフレーム数が numFrames 未満の場合に発生します。
IllegalArgumentException - 設定されたキャリア情報が不正な場合に発生します。
IllegalArgumentException - 設定されたパルス情報が不正な場合に発生します。
IllegalArgumentException - 設定されたフレーム情報が不正な場合に発生します。
SecurityException - 端末がセルフモードの場合に発生します。
DeviceException - ネイティブ側で既に赤外線送信中の場合に発生します(OBEX 通信も含む)(BUSY_RESOURCE)。
DeviceException - [DoJa-5.0 (903i) 以降] アドホック通信中の場合に発生します(RACE_CONDITION)。
DeviceException - パケット通信中の場合に発生します(RACE_CONDITION)。
[DoJa-3.5 (900i) 以降] メール着信動作中の場合も含みます。
[DoJa-3.0 (506iC) 以降 ただし、DoJa-3.5 (900i) を除く] リモート制御によるパケット通信中の場合も含みます。
[DoJa-4.1 (902i) 以降] PTT呼通信中、PTT設定中の場合に発生します。
[DoJa-5.1 (905i) 以降] ミュージックチャネルダウンローダが起動中の場合にも発生します。

[DoJa-5.1 (906i) 以降] ソフトウェア更新のダウンロード通知機能が起動中の場合にも発生します。
DeviceException - [DoJa-3.5 (900i) 以降] 音声・テレビ電話通話中の場合に発生します(RACE_CONDITION)。
DeviceException - [DoJa-4.0LE、DoJa-5.0 (903i) 以降] 測位中である場合に発生します(RACE_CONDITION)。
[DoJa-5.0 (903i) 以降] LocationProvider.setTrackingListener(TrackingListener listener, int interval, int timeout) の引数 listener に、null 以外が設定されている場合も含みます。

send

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

パラメータ:
numFrames - 送信データのフレーム数(1以上)を指定します。
frames - 送信データフレームの配列を指定します。
例外:
IllegalStateException - 送信するアプリケーションが待ち受け非活性状態の場合に発生します。
NullPointerException - frames が null の場合に発生します。
ArrayIndexOutOfBoundsException - numFrames 値が0以下の場合に発生します。
NullPointerException - frames が null ではなく、 配列の要素中に null が設定されている場合に発生します。
ArrayIndexOutOfBoundsException - frames に含まれるフレーム数がnumFrames未満の場合に発生します。
IllegalArgumentException - 設定されたキャリア情報が不正な場合に発生します。
IllegalArgumentException - 設定されたパルス情報が不正な場合に発生します。
IllegalArgumentException - 設定されたフレーム情報が不正な場合に発生します。
SecurityException - 端末がセルフモードの場合に発生します。
DeviceException - ネイティブ側で既に赤外線送信中の場合に発生します(OBEX 通信も含む)(BUSY_RESOURCE)。
DeviceException - [DoJa-5.0 (903i) 以降] アドホック通信中の場合に発生します(RACE_CONDITION)。
DeviceException - パケット通信中の場合に発生します(RACE_CONDITION)。
[DoJa-3.5 (900i) 以降] メール着信動作中の場合も含みます。
[DoJa-3.0 (506iC) 以降 ただし、DoJa-3.5 (900i) を除く] リモート制御によるパケット通信中の場合も含みます。
[DoJa-4.1 (902i) 以降] PTT呼通信中、PTT設定中の場合に発生します。
[DoJa-5.1 (905i) 以降] ミュージックチャネルダウンローダが起動中の場合にも発生します。

[DoJa-5.1 (906i) 以降] ソフトウェア更新のダウンロード通知機能が起動中の場合にも発生します。
DeviceException - [DoJa-3.5 (900i) 以降] 音声・テレビ電話通話中の場合に発生します(RACE_CONDITION)。
DeviceException - [DoJa-4.0LE、DoJa-5.0 (903i) 以降] 測位中である場合に発生します(RACE_CONDITION)。
[DoJa-5.0 (903i) 以降] LocationProvider.setTrackingListener(TrackingListener listener, int interval, int timeout) の引数 listener に、null 以外が設定されている場合も含みます。

send

public void send(int numFrames,
                 IrRemoteControlFrame[] frames,
                 int timeout,
                 int count)
タイムアウト値、送信する回数を指定して信号を送信します。 numFrames 値によって指定された数のフレームデータを送信します。 タイムアウトする、 stop メソッドが呼ばれる、又はその他の条件により送信が中断されるまで、 指定した回数だけ送信を繰り返します。 あるフレームの送信回数が無限回に指定されている場合には、 それ以降のフレームは送信されません。 このメソッドは非同期に実行され、ブロックしません。

パラメータ:
numFrames - 送信データのフレーム数(1以上)を指定します。
frames - 送信データフレームの配列を指定します。
timeout - タイムアウト値(sec)を指定します。
count - 信号を送信する回数を指定します。
例外:
IllegalStateException - 送信するアプリケーションが待ち受け非活性状態の場合に発生します。
NullPointerException - 引数 frames がnullの場合に発生します。
IllegalArgumentException - timeout値が範囲外の場合に発生します。
IllegalArgumentException - 引数 count に 0 以下の値を指定した場合に発生します。
ArrayIndexOutOfBoundsException - 引数 numFrames の値が 0 以下の場合に発生します。
NullPointerException - frames がnullではなく、配列の要素中に null が設定されている場合に発生します。
ArrayIndexOutOfBoundsException - 引数 frames に含まれるフレーム数が numFrames 未満の場合に発生します。
IllegalArgumentException - 設定されたキャリア情報が不正な場合に発生します。
IllegalArgumentException - 設定されたパルス情報が不正な場合に発生します。
IllegalArgumentException - 設定されたフレーム情報が不正な場合に発生します。 引数 frames に設定されているフレームリピート時間が、 フレームデータを送信するのに必要な時間より少ない場合や、 引数 frames に設定されているいずれかの要素に、 未設定のパラメータが存在する IrRemoteControlFrame オブジェクトが存在する場合も含みます。
SecurityException - 端末がセルフモードの場合に発生します。
DeviceException - ネイティブ側で既に赤外線送信中の場合に発生します(OBEX 通信も含む)(BUSY_RESOURCE)。
DeviceException - [DoJa-5.0 (903i) 以降] アドホック通信中の場合に発生します(RACE_CONDITION)。
DeviceException - パケット通信中の場合に発生します。 メール着信動作中の場合やリモート制御によるパケット通信中、PTT呼通信中、PTT設定中の場合も含みます (RACE_CONDITION)。
[DoJa-5.1 (905i) 以降] ミュージックチャネルダウンローダが起動中の場合にも発生します。

[DoJa-5.1 (906i) 以降] ソフトウェア更新のダウンロード通知機能が起動中の場合にも発生します。
DeviceException - 音声・テレビ電話通話中の場合に発生します(RACE_CONDITION)。
DeviceException - [DoJa-5.0 (903i) 以降] 測位中である場合に発生します(RACE_CONDITION)。
[DoJa-5.0 (903i) 以降] LocationProvider.setTrackingListener(TrackingListener listener, int interval, int timeout) の引数 listener に、null 以外が設定されている場合も含みます。
導入されたバージョン:
DoJa-4.1(902i)

stop

public void stop()
Ir 信号の送信を停止します。


setCarrier

public void setCarrier(int highDuration,
                       int lowDuration)
キャリア情報を設定します。

パラメータ:
highDuration - キャリアHigh時間(0.1 usec)。
lowDuration - キャリアLow時間(0.1 usec)。
例外:
IllegalArgumentException - High,Low時間が0以下の場合に発生します。

setCode0

public void setCode0(int pattern,
                     int highDuration,
                  RESOURCE)縲