MaBeee Mac App
Python
Switch branches/tags
Nothing to show
Clone or download
Latest commit ef32415 Aug 16, 2016
Permalink
Failed to load latest commit information.
.gitignore first commit Aug 4, 2016
MaBeeeMacApp.zip Version 1.3 Aug 16, 2016
README.md Update README.md Aug 16, 2016
mabeee.py mabeee.pyでURLも出力する Aug 5, 2016

README.md

MaBeeeMacApp

MaBeeeMacAppはMaBeeeをMacからコントロールできるようにするアプリです。UIを用意していないので開発者向けという感じです。ツアーで雰囲気がわかります。

注意

  • 現在のところMaBeeeはiOSアプリ、Androidアプリからの使用のみサポートされています。
  • こちらのMacアプリは正式なサポート対象ではなく、あくまでMaBeee開発者の趣味レベルのものです。
  • ご使用の際はその旨ご理解の上、自己責任でお願い致します。

インストール・実行

  1. このリポジトリをクローンなりダウンロードなりしてください。
  2. MaBeeeMacApp.zipを解凍します。
  3. 解凍してできたフォルダの中の、MaBeee.appがアプリになりますので、適当なところに置いてください。
  4. 野良アプリなので署名がありません、実行するときは右クリックか2本指タップのコンテキストメニューから、「開く」を選んで実行してください。

アイコン・終了

  • 実行すると上部メニューバーの右側に、電池っぽいアイコンが表示されます。
  • 電池アイコンをクリックして「Quit MaBeee」を選択すると終了できます。

仕組み・概要

  1. 実行すると、http://localhost:11111/でWebサーバーが起動します。
  2. このWebサーバーにHTTP GETでリクエストを送信することで、アプリに指示を出します。
  3. アプリは指示にしたがってMaBeeeをスキャンしたり出力を変更したりします。

API

  • HTTP GETでlocalhost:11111にリクエストを送信してください。
  • ネットワーク経由で操作されないように、localhost, 127.0.0.1以外のホスト名、IPでアクセスできないようにしたつもりです。
  • Access-Control-Allow-Origin "*" です。
API (Path) 概要 リンク
/ MaBeeeMacAppの状態のサマリを返します 詳細
/state Bluetoothの状態を返します 詳細
/scan スキャンの状態を返します 詳細
/scan/start スキャンを開始します 詳細
/scan/stop スキャンを停止します 詳細
/devices デバイスの一覧を返します 詳細
/devices/:id :idで指定したデバイスの情報を返します 詳細
/devices/:id/connect :idで指定したデバイスに接続します 詳細
/devices/:id/disconnect :idで指定したデバイスを切断します 詳細
/devices/:id/set :idで指定したデバイスに値を設定します 詳細
/devices/:id/update :idで指示したデバイスのプロパティの更新を指示します 詳細

ツアー

APIを一通り使ってみるツアーを準備しました。

ライブラリ

MaBeeeMacAppでは、Webサーバーの実装にGCDWebServerを使用しています。素晴らしいライブラリに感謝します。