Proximity Profile

目次

API	機能概要
Proximity Device Event API	スマートデバイスの近接センサーの物の検知を通知する。スマートデバイスの近接センサーの情報を近接距離最小/最大値の範囲で連続的にイベント発行する。
Proximity User Event API	スマートデバイスの近接センサーのユーザ検知を通知する。ユーザ検知とは、例えば通話時にスマートフォンの画面を耳元に近接させた場合等に発生する。

機能概要

スマートデバイスの近接センサーの物/人の検知を通知するAPI。

参考API

http://www.w3.org/TR/2013/CR-proximity-20131001/

Proximity Device Event API

インターフェース名称	Version	種別
Proximity Device Event API	2.0.0	非同期I/F(イベントI/F)

概要

スマートデバイスの近接センサーの物の検知を通知する。 スマートデバイスの近接センサーの情報を近接距離最小/最大値の範囲で連続的にイベント発行する。

イベント情報

イベント名	Content-Type
/gotapi/proximity/ondeviceproximity	application/json

メッセージ

論理名	物理名		データ型	省略	設定値
オブジェクト	proximity		object	-	近接センサーデータ
近接距離		value	number	○	cm単位の距離。
近接距離最小値		min	number	○	cm単位の距離。
近接距離最大値		max	number	○	cm単位の距離。
閾値		threshold	number	○	cm単位の距離の閾値。
距離識別子		range	string	○	距離に応じた文字列。IMMEDIATE,NEAR,FAR,UNKNOWN

メッセージサンプル

{
    "product":"Device Connect Manager",
    "version":"x.x",
    "serviceId":"localhost.deviceconnect.org",
    "api" : "gotapi",
    "profile":"proximity",
    "attribute":"ondeviceproximity",
    "sessionKey":"0a93ac0aade4e046ed63eb24d1172f5f35c88ca60daa901547c28d5827cb418a5de1d7c5f9e62405",
    "proximity":{
        "value":10,
        "min":5,
        "max":100,
        "threshold":50,
        "range":"IMMEDIATE"
    }
}

Proximity User Event API

インターフェース名称	Version	種別
Proximity User Event API	2.0.0	非同期I/F(イベントI/F)

概要

スマートデバイスの近接センサーのユーザ検知を通知する。 ユーザ検知とは、例えば通話時にスマートフォンの画面を耳元に近接させた場合等に発生する。

イベント情報

イベント名	Content-Type
/gotapi/proximity/onuserproximity	application/json

メッセージ

論理名	物理名		データ型	省略	設定値
オブジェクト	proximity		object	-	近接センサーデータ
近接の有無		near	boolean	-	ユーザがデバイスに近接しているかどうか。 true: 近接している false: 近接していない

メッセージサンプル

{
    "product":"Device Connect Manager",
    "version":"x.x",
    "serviceId":"localhost.deviceconnect.org",
    "api" : "gotapi",
    "profile":"proximity",
    "attribute":"onuserproximity",
    "sessionKey":"0a93ac0aade4e046ed63eb24d1172f5f35c88ca60daa901547c28d5827cb418a5de1d7c5f9e62405",
    "proximity":{
        "near":true
    }
}