Skip to content

Latest commit

 

History

History
474 lines (436 loc) · 14.7 KB

readme.ja.md

File metadata and controls

474 lines (436 loc) · 14.7 KB

DeviceConnectレポジトリの移行

DeviceConnectのレポジトリを以下のように移行しました。

DeviceConnect-Docs:　ドキュメントとバイナリー https://github.com/DeviceConnect/DeviceConnect-Docs

DeviceConnect-Android: Androidプラットフォームのソースコード https://github.com/DeviceConnect/DeviceConnect-Android

DeviceConnect-JS: JavaScriptプラットフォームのソースコード https://github.com/DeviceConnect/DeviceConnect-JS

DeviceConnect-iOS: iOSプラットフォームのソースコード https://github.com/DeviceConnect/DeviceConnect-iOS

DeviceConnect-Common: デバイスアプリのソースコード https://github.com/DeviceConnect/DeviceConnect-Common

DeviceConnect WebAPI について

Device Connect WebAPIはスマートフォン上で仮想サーバとして動作するWebAPIで、様々なウェアラブルデバイスやIoTデバイスをWebブラウザやアプリから統一的な記述で簡単に利用することができます。

  • 動作環境として、Android、iOSに対応しています。WebブラウザとしてはChrome、Safari(擬似的な仕組み)、Firefoxで動作を確認しています。
    ※それぞれの動作環境で利用できる対応デバイスは異なります。
  • 仮想サーバによるREST/WebSocketのWebAPIにより、任意の開発環境がご利用いただけます。
  • コンテンツ開発を容易にするために、Javascript用SDK、Android用SDK、iOS用SDKを用意しています。
  • 機能拡張のためのプラグイン開発用SDKを用意しております。任意のWebAPI機能の追加が可能です。
  • 同じローカルネットワーク上にあるDeviceConnect WebAPIがセットアップされたAndroid端末も設定変更で利用できます（セキュリティ上のリスクについてご留意いただく必要があります）。

サンプルでの動作確認（Android用）

2014/10/15にAndroid用動作サンプルのAPKファイルのパッケージ名を一部更新しました。 お手数ですが以前のAPKがインストールされている場合、以下の手順で旧データを削除してからご確認ください。

  1. 内部ストレージのdemoWebSite.zipから展開したファイルを削除
  2. DeviceConnect ManagerおよびPlug-inのAPKをアンインストール
  3. （Chromeブラウザの場合）メニューの”履歴”から”閲覧履歴データの消去...”を選択
  4. ”キャッシュの消去”のチェックを有効化し、”クリア”ボタンを選択

Android端末でのChromeブラウザからの動作確認

  1. Androidの内部ストレージにデモコンテンツをフォルダを作成し（[例]"dConnect"）、
    そこにサンプルのdemoWebSiteフォルダ以下のすべてのファイルをコピーしてください。
Android root
   └── mnt
       └── sdcard
           └── dConnect #ここにフォルダを作成
                └── demoWebSite #ここにjavaScriptのサンプルをコピー
  1. Chromeブラウザのアドレス欄に内部ストレージのURIを記入し、
    内部ストレージにあるWebコンテンツにアクセスしてください。
    [例] file:///storage/emulated/0/dConnect/demoWebSite/index.html
  1. "Download APK"のリンクから、Device Connect本体の"DeviceConnectManager"、
    デバイスプラグインの"Android Host"をダウンロードし、インストールしてください。

※設定のセキュリティから、提供元不明のアプリのインストールの許可が必要です。

  1. トップページに戻ってください。

  2. "Launch UI-App"のリンクからDeviceConnectWebAPIの動作をご確認ください。

  • CheckボタンでDeviceConnectWebAPIの動作状況の確認が行えます。
  • 未起動の場合、"Device Connect was not found."と表示されます。
  • DeviceConnectManagerがインストールされていれば、設定画面が表示されます。
  • DeviceConnectManagerをONにしてWeb画面に戻り、もう一度Checkボタンを押すとDevice Connect API version:1.0と表示されます。
  • accessTokenボタンでコンテンツからのデバイス機能アクセスを許可します。
  • Search Deviceボタンを押すとインストールされているプラグインのリストが表示されます。
  • HOSTを選ぶと利用できる機能の一覧（Profile List）が表示されます。
  • そこから、vibrationを選び、Vibrateを選ぶと端末が振動します（最初の利用時にプラグイン利用の許可が必要です）。

##外部からのアクセスについて

  • demoWebSiteのURLにIPアドレスのパラメータを付加することで、ローカルネットワーク上の他の端末で動作するDeviceConnect WebAPIの操作も可能になります。ただし、操作される側の端末に以下の設定が必要です。

※遠隔で意図しない端末の操作およびデータ参照をされるリスクが伴います。信頼が出来ないローカルネットワーク環境では利用しないでください。

  1. 上記の動作確認と同様の手順で、操作対象の端末にDeviceConnect WebAPIをセットアップしてください。

  2. DeviceConnectManagerをAndroidのランチャーから起動し、DeviceConnectManagerを一旦OFFにしてください。

  3. Allow External IPのチェックを有効化し、DeviceConnectManagerをONにしてください。

  4. 操作する側（PC等）のdemoWebSiteからHTMLを開き、操作対象のIPアドレスのパラメータを付加してください。

    [例] file:///C:/demoWebSite/demo/index.html?ip=192.168.13.3

※遠隔で意図しない端末の操作およびデータ参照をされるリスクが伴います。信頼が出来ないローカルネットワーク環境に接続される可能性がある場合はDeviceConnectManagerのAllow External IPのチェックを無効化してください

対応デバイス

メーカー 製品名 機器種別 対応プラグイン Android iOS 備考
SONY SmartWatchMN2 腕時計型デバイス MN2/SW2 プラグイン ○ × 通知以外の機能を利用するには、スマートウォッチ側でミニアプリの起動が必要
SONY SmartWatchSW2 腕時計型デバイス MN2/SW2 プラグイン ○ × 通知以外の機能を利用するには、スマートウォッチ側でミニアプリの起動が必要
Orbotix Sphero 2.0 ボール型スマートトイ Sphero プラグイン ○ ○
Game Technologies DICE+ サイコロ型スマートトイ DICE+ プラグイン ○ ○ ソースコード開示なし、開発者向けファームウェアへのアップデートが必要
Philips hue スマートライト hue プラグイン ○ ○
Philips Bloom Lamp スマートライト hue プラグイン ○ ○
Philips LightStrips スマートライト hue プラグイン ○ ○
IRKit IRKit 赤外線リモコン IRKit プラグイン ○ ○ 学習した赤外線機器を紐付け
Epson Moverio BT-200 メガネ型デバイス AndroidHost プラグイン ○ × 個別の拡張機能にも対応予定
Vuzix M100 Smart Glass メガネ型デバイス AndroidHost プラグイン ○ × 個別の拡張機能にも対応予定
ウエストユニティス Inforod メガネ型デバイス AndroidHost プラグイン ○ × 個別の拡張機能にも対応予定
SONY DSC-QX100 レンズスタイルカメラ SonyCamera プラグイン ○ ○
SONY DSC-QX10 レンズスタイルカメラ SonyCamera プラグイン ○ ○
SONY ActionCam レンズスタイルカメラ SonyCamera プラグイン ○ ○
Pebble Pebble 腕時計型デバイス Pebble プラグイン ○ ○
- Android端末 Ver4.2以降 Android端末 AndroidHost プラグイン ○ ×
LG G Watch Android Wear端末 Wear プラグイン ○ × 仮対応のため、ADBでのAPKのインストールが必要
Samsung Gear Live Android Wear端末 Wear プラグイン ○ × 仮対応のため、ADBでのAPKのインストールが必要
Google ChromeCast HDMIドングル ChromeCast プラグイン ○ ○ Google Cast SDK Developer ConsoleのページでデバイスとReceiverアプリの登録が必要
Google NexusPlayer AndroidTV ChromeCast プラグイン ○ ○ Google Cast SDK Developer ConsoleのページでデバイスとReceiverアプリの登録が必要
Polar H7 心拍計 BLE HeartRate プラグイン ○ ×
Mio Global Mio Alpha 心拍計 BLE HeartRate プラグイン ○ ×
Mio Global Mio Fuse 心拍計 BLE HeartRate プラグイン ○ ×
EPSON Pulsense PS-500 心拍計 BLE HeartRate プラグイン ○ ×
EPSON Pulsense PS-100 心拍計 BLE HeartRate プラグイン ○ ×
NTTドコモ Hitoe/td> 心拍計、他 Hitoe プラグイン ○ ○ 開発中
A&D UT-201BLE 体温計 ○ x
OMRON HVC-C Human Vision Components HVC プラグイン ○ ×
OMRON HVC-C2W Human Vision Components HVC2W プラグイン ○ ×
OMRON HVC-P Human Vision Components HVCP プラグイン ○ ×
FUJITSU F-PLUG スマートメーター F-PLUG プラグイン ○ ×
RICOH THETA m15 Spherical Camera THETAデバイスプラグイン ○ ○ RICOH THETA Developersにて開発者登録、およびSDKのダウンロードが必要。
LIFX White 800 ライト AllJoynプラグイン ○ ○ White 800の色は変えられない。
EchonetLite 家電製品制御 EchoneLiteプラグイン ○ × 準拠機器全般
Linking BLE連携デバイス Linkingプラグイン ○ ○ 準拠機器全般。開発中
UVC(USB Video Class) Webカメラ UVCプラグイン ○ ×
テレビ会議 WebRTCプラグイン ○ ×
インフィニテグラ OWLIFT サーマルカメラ ○ ×
FaBo FaBo IoTHWプロトタイプキット FaBoプラグイン ○ ×
  • 本プロジェクトはＮＴＴドコモとしての正式なサービス提供ではなく、実験的なソースコード開示です。仕様やセキュリティの検討を目的としております。
  • 各メーカーが動作を保障するものではありません。
  • 利用できる機能は各機器で異なります。
  • 利用する開発用ライブラリの都合により、プラグインのソースコードは一部機器についての開示となります。
  • 各種ドキュメントの整備、対応デバイスの拡大についても順次進めていく予定です。
  • 利便性の改善やセキュリティ向上のため、仕様が変更となる場合があります。予めご了承ください。