com.docomostar.io
インタフェース HDPConnection

すべてのスーパーインタフェース:

BTConnection

public interface HDPConnection
extends BTConnection

[iアプリオプションAPI]

Health Device Profile (HDP)で通信を行う場合の接続を定義します。 Health Device Profile (HDP)を使ったデータの入出力のためにストリームを取得することができます。 端末がサスペンドし、レジュームした際でも、サスペンド前に取得済みのストリームを継続して利用することができます。

以下のメソッドの引数に Bluetooth.HDP を指定した場合、 戻り値としてこのクラスのインスタンスが返されます。

• RemoteDevice.connect(int)
• RemoteDevice.accept(int)

Health Device Profile (HDP)は、同時に複数のデータ通信路を使用して通信を行うことができます。 ただし、同時に使用できる通信路の数は接続先の外部機器に依存します。

入出力ストリームごとに使用する通信路は、接続先の MDEP(MCAP Data End Point) の情報で決定します。 接続先の MDEP は、getMDEPList() メソッドで取得することができます。 MDEP に含まれる情報の一つである MDEP Data Type から、 使用目的に合ったデータ種別を送受信できる通信路であるかどうか判断します。

入出力ストリームを取得するとき、 MDEP に含まれる情報の一つである MDEP ID をメソッドの引数に指定します。 このとき指定する MDEP ID は、本来8ビット符号なし整数で表される MDEP ID をそのまま int にキャストした値です。 すなわち、MCAPDataEndPoint.getMDEPId() で返される値を直接指定してください。

データ通信路が開かれるタイミング、および使用されるデータ通信路の種類は、 接続先の外部機器に依存します。

導入されたバージョン:

Star-1.5

関連項目:

Bluetooth, RemoteDevice, BTStateListener, BTConnection, MCAPDataEndPoint

メソッドの概要

MCAPDataEndPoint[]	getMDEPList() 接続先の機器が持つ MDEP のリストを取得します。
java.io.InputStream	openInputStream(int id) データを読み出すための入力ストリームを返します。
java.io.OutputStream	openOutputStream(int id) データを書き出すための出力ストリームを返します。

インタフェース com.docomostar.io.BTConnection から継承されたメソッド

close, setBTStateListener

メソッドの詳細

openInputStream

java.io.InputStream openInputStream(int id)
                                    throws java.io.IOException

データを読み出すための入力ストリームを返します。

パラメータ:

id - 接続先の機器の MDEP ID を指定します。 MDEP ID は、MCAPDataEndPoint.getMDEPId() で返される値です。

戻り値:

入力ストリームを返します。

例外:

RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。

IllegalArgumentException -
引数 id が不正な値の場合に発生します。

ConnectionException -
(UNDEFINED)
Bluetoothの切断を検知した場合に発生します。

java.io.IOException -
ネイティブで通信エラーが起きた場合に発生します。

openOutputStream

java.io.OutputStream openOutputStream(int id)
                                      throws java.io.IOException

データを書き出すための出力ストリームを返します。

パラメータ:

id - 接続先の機器の MDEP ID を指定します。 MDEP ID は、MCAPDataEndPoint.getMDEPId() で返される値です。

戻り値:

出力ストリームを返します。

例外:

RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。

IllegalArgumentException -
引数 id が不正な値の場合に発生します。

ConnectionException -
(UNDEFINED)
Bluetoothの切断を検知した場合に発生します。

java.io.IOException -
ネイティブで通信エラーが起きた場合に発生します。

getMDEPList

MCAPDataEndPoint[] getMDEPList()

接続先の機器が持つ MDEP のリストを取得します。

このメソッドを複数回呼び出した場合、呼び出す度に新しい配列が生成され、 その配列への参照が返されます。

戻り値:

MDEP をリストとして返します。