com.docomostar.device.RemoteDevice
|
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||
Object
public class RemoteDevice
Bluetoothで端末と接続される外部機器を表すクラスを定義します。
外部機器との接続は、
Star アプリから接続要求(connect(int profile))を出すか、
もしくはその外部機器からの接続要求を受け付けること(accept(int profile))で行います。
同じ Bluetooth アドレスを持つ有効なインスタンスが複数存在することはありません。
ネイティブ機能により、このオブジェクトの外部機器が削除された場合、 例外 DeviceException(ILLEGAL_STATE) が発生します。 この例外が発生した場合には、dispose() により、このオブジェクトを破棄しなければなりません。
[Star-1.5 以降]
非同期に外部機器からの接続要求を待ち受けることができます。
接続要求を待ち受けるには、
StarApplication.addEventListener(int, StarEventListener)
を使って、
StarEventObject.STAR_BLUETOOTH_CONNECT_REQUEST_RECEIVED
イベントを待ち受けてください。
接続要求を受け付けたタイミングで BluetoothConnectionEvent が通知され、
BluetoothConnectionEvent の付随パラメータとして、
接続要求元の外部機器情報を保持した DeviceDiscoveryResult オブジェクトを取得します。
この DeviceDiscoveryResult オブジェクトを
Bluetooth.getDiscoveredRemoteDevice(DeviceDiscoveryResult)
に指定して、RemoteDevice オブジェクトを取得することができます。
このようにして得られた RemoteDevice オブジェクトに対して
Bluetooth.HDP を指定した accept(int) を呼び出すことで、
BTConnection を取得し、データ送受信を開始することができます。
この外部機器を、起動可能外部機器リストに追加することで、
この Star アプリケーション終了後もなお、接続要求を待ち受けることができます。
Star アプリケーション終了後に、リストに追加済みの外部機器から接続要求を受け付けた場合、
この Star アプリケーションが、
起動タイプ
LAUNCHED_BY_BLUETOOTH_REMOTE_DEVICE
で自動起動します。
詳細は StarEventObject.STAR_BLUETOOTH_CONNECT_REQUEST_RECEIVED
フィールド説明を参照してください。
Bluetooth,
BTStateListener,
BTConnection,
SPPConnection,
StarApplicationManager.addRemoteLauncher(RemoteDevice),
StarEventObject.STAR_BLUETOOTH_CONNECT_REQUEST_RECEIVED| フィールドの概要 | |
|---|---|
static int |
SNIFF_MODE
省電力状態(SNIFFモード)であることを表します(=1)。 |
| メソッドの概要 | |
|---|---|
BTConnection |
accept(int profile)
外部機器からの接続要求を待ち受けます。 |
void |
changePowerMode(int type)
外部機器に対して、省電力状態(SNIFF_MODE)への遷移をリクエストします。 |
BTConnection |
connect(int profile)
外部機器と接続を行います。 |
void |
dispose()
このオブジェクトを破棄します。 |
String |
getAddress()
外部機器のBluetoothアドレスを取得します。 |
String |
getDeviceClass()
外部機器の端末属性情報(CoD)を取得します。 |
DeviceDiscoveryResult |
getDeviceDiscoveryResult()
Device Discovery 処理で得られたこの外部機器の情報を取得します。 |
String |
getDeviceName()
外部機器の名称を取得します。 |
void |
interruptAcceptance()
外部機器からの接続要求に対する待ち受けを中断させます。 |
boolean |
isAvailable(int profile)
引数で指定したプロファイルが外部機器で利用可能かどうかを確認します。 |
| クラス Object から継承されたメソッド |
|---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| フィールドの詳細 |
|---|
public static final int SNIFF_MODE
| メソッドの詳細 |
|---|
public String getAddress()
取得されるアドレスは、"2DIGIT":"2DIGIT":"2DIGIT":"2DIGIT":"2DIGIT":"2DIGIT"の形式（例えば、00:11:22:33:BB:DD)で表現されます。取得された値は、ネイティブ側の登録機器情報で表示されるアドレスと一致します。
DeviceException - DeviceException - public String getDeviceName()
取得された値は、ネイティブ側の登録機器情報で表示される機器名称と一致します。
DeviceException - DeviceException - public String getDeviceClass()
取得された値は、ネイティブ側の登録機器情報で表示される端末属性情報(CoD)と一致します。
DeviceException - DeviceException - public boolean isAvailable(int profile)
利用可能な場合にはtrueを返します。利用不可能な場合にはfalseを返します。
profile - Bluetooth
クラスのフィールドとして定義されているプロファイル種別を指定します。
DeviceException - DeviceException - public BTConnection connect(int profile)
メソッドの引数に利用するプロファイルを指定して接続します。 接続した際には指定したプロファイルで接続した状態（すなわち、ACLからプロファイルまでが繋がった状態）となります。 引数に SPPを指定した場合にはSPPで接続した状態となって接続します。 接続に成功した場合に BTConnectionオブジェクトを返します。
引数に指定したプロファイル種別によって、 返される BTConnection オブジェクトの実行時の型は異なります。 詳細は BTConnection インタフェース説明を参照してください。
メソッドを実行した際、Star アプリはサスペンドせずに接続処理を行います。このメソッドはブロッキングメソッドです。接続の成否に関係なく、処理が完了するまで、このメソッドは戻りません。
リンクキーが無効な場合は、例外を発生します。
profile - Bluetooth
クラスのフィールドとして定義されているプロファイル種別を指定します。
DeviceException - DeviceException - IllegalArgumentException -
SecurityException -
DeviceException - DeviceException - DeviceException - DeviceException - BluetoothException - BluetoothException - BluetoothException - BluetoothException - BluetoothException - BluetoothException - イベントリスナにより接続要求を待っている場合に発生します。
BluetoothException - DeviceException - public BTConnection accept(int profile)
メソッドの引数に利用するプロファイルを指定して接続要求を待ち受けます。 接続した際には指定したプロファイルで接続した状態（すなわち、ACLからプロファイルまでが繋がった状態）となります。 引数に SPPを指定した場合にはSPPで接続した状態となって接続します。 接続に成功した場合に BTConnectionオブジェクトを返します。
引数に指定したプロファイル種別によって、 返される BTConnection オブジェクトの実行時の型は異なります。 詳細は BTConnection インタフェース説明を参照してください。
メソッドを呼び出した場合、Star アプリはサスペンドせずに接続処理を行います。このメソッドはブロッキングメソッドです。接続の成否に関係なく、処理が完了するまで、このメソッドは戻りません。 リンクキーが無効な場合は例外が発生します。
profile - Bluetooth
クラスのフィールドとして定義されているプロファイル種別を指定します。
DeviceException - DeviceException - IllegalArgumentException -
SecurityException -
DeviceException - DeviceException - DeviceException -