Muse Bridge v0.9.3（旧称 EnvSensorBridge）
=========================================

Android端末を自分の Muse（AI）と連携させるための、非公式の橋渡しアプリです。
v0.6 でアプリ名を「Muse Bridge」に変更しました（アプリIDは従来どおりで、
v0.5 以前からの更新インストールが可能です）。

※ Muse に使わせるための機能です。同梱の FOR_MUSE.md が
Muse 宛の機能説明・操作仕様になっています。導入時はまず
そちらを Muse に読ませてください。

v0.9.3 の変更
- センサーの LED 表示ルールを、そのまま設定できるように
  なりました。POST /control {"action":"led_set","rule":2}
  で、選択中のセンサー（"mac" で個体指定も可）の通常時 LED
  をルール変更します。ルールは 0=消灯、1=常時点灯（"rgb"
  で色指定）、2=気温スケール（10〜35℃で青→赤）、3=湿度、
  4=照度、5=気圧、6=騒音、7=eTVOC、8=SI値、9=PGA の
  センサー内蔵スケール表示です。設定はセンサー本体に保存
  され、電源を切っても残ります。応答には変更前の設定
  （before）が入るので、戻したい時はその値で led_set を
  再度送ってください

v0.9.2 の変更
- ヘッダーのキャラをタッチするとセリフが出るようになりました
  - びっくり時：実際に起きたイベントの内容を表示し、顔は
    通常に戻ります（10分待たなくてよくなりました）
  - エラー時：実際のエラーの内容を表示します
  - 通常時・おやすみ時：設定の「キャラのセリフ」で自由に
    編集できるセリフを表示します（急変とエラーのセリフは
    実際の内容が大事な情報なので、編集対象外です）

v0.9.1 の変更
- ヘッダーの状態表示キャラに「びっくり」が増えました。
  急変イベントが起きると、その後10分間、キャラが‼️付きの
  びっくり顔になります（通常・おやすみ・エラーに続く4つ目
  の表情です。差し替え画像の名前は chara_surprise_1.png /
  chara_surprise_2.png）

v0.9.0 の変更
- センサーの LED で合図を送れるようになりました。
  POST /control {"action":"led_signal"} で、選択中のセンサー
  （"mac" で個体指定も可）の LED を数秒間点灯し、元の LED
  設定に自動で戻します。色は "rgb":[r,g,b]、長さは "seconds"
  （1〜8、既定5）で指定できます。窓口の開閉に関係なく使えます
- GET /read?all=1 で、届く範囲のセンサーを全部まとめて
  読めるようになりました。選択中のセンサーの値は従来どおり
  最新値として保持され、他のセンサーの値も応答に含まれます
- 急変イベントを記録するようになりました。気圧・温度の急な
  段差、騒音の跳ね、揺れ（震度相当0.1以上）を、センサーごと
  の履歴の中で検知して端末内に保存します（センサーを切り
  替えた時の見かけの段差は誤検知しません）。
  GET /events.json で新しい順に取得できます

v0.8.1 の変更
- 「PCを起こす」を折りたたみの中に戻しました（v0.8.0 の再設計で
  ボタンが常時見える形になっていました）。普段は閉じていて、
  開いてから押す二段階なので、うっかり触れて PC が起きる
  ことはありません
- ダークモードでカードだけが黒く浮いて見える（パンダ状になる）
  表示を直しました。色は端末のテーマ背景から判定します
- ステータスヘッダーの各行（サービス／接続／センサー／心拍）と
  キャラ表示を、行ごとに表示・非表示できるようになりました
  （「記録とシステム」内の「表示設定」から）。行を消すと
  ヘッダーがその分詰まります。全行を消すとヘッダー自体が
  消えます。使わない機能の行は消して使えます
- ヘッダー右端に、状態を表す小さな SD キャラ表示を追加しました。
  サービス停止中＝ねむり、読み取りエラー時＝はてな、それ以外＝
  接続中の3状態で、約0.9秒ごとに2コマが切り替わります。
  サンプルとして「ルルナ」の SD イラスト（透過 PNG）が最初から
  入っています。画像は差し替え可能で、端末の
  Android/data/app.envsensor.bridge/files/chara/ フォルダーに
  chara_ok_1.png のような名前（状態 ok／sleep／error ×
  コマ 1／2）で PNG を置くと、アプリ再起動後にそちらが
  使われます

v0.8.0 の変更
- 画面を再設計しました（見た目と分類の変更で、動作と HTTP の
  仕様は従来どおりです）。最上部に、スクロールしても残る固定の
  ステータスヘッダーを置きました。サービス／接続／センサー／
  心拍の4行が「色ドット＋状態を表す一語＋詳細＋何分前か」で
  一目に分かり、サービスが止まっている時はヘッダーの中に
  「開始」ボタンが出ます
- 機能の並びを「センサー」「スマホ機能」「記録とシステム」の
  3グループに再分類しました。スマホ機能はスイッチ行（現在の
  状態を示す副文つき）に統一し、撮影アシストはカメラの従属行
  になりました
- 「接続」の行には、VPN（このアプリの通信経路）の有無に加えて、
  登録した PC へ実際に接続できるか（到達性）を確認時刻つきで
  表示します。確認先は「宛先を設定」の任意項目「接続確認先
  ホスト」、または HTTP の set_wol_target の host で登録します。
  行をタップすると再確認します
- 蓄積データの「メモリ消去」をグループの末尾に離し、確認
  ダイアログの文面を具体的にしました（何が消えるか・取り消し
  できないこと・所要時間）
- 権限 ACCESS_NETWORK_STATE を追加しました（接続状態の表示用。
  通常権限で、許可ダイアログは出ません）

v0.7.3 の変更
- Wake-on-LAN を追加しました。登録した PC へマジックパケットを
  送って、スリープから起こせます。アプリ画面の「PCを起こす」
  折りたたみにあるボタン、または HTTP の wake_pc から送信
  できます。宛先（PC の有線 LAN の MAC・ブロードキャスト・
  ポート）はアプリ画面の「宛先を設定」、または HTTP の
  set_wol_target で登録します。状態は /status の wol で
  確認できます。送信の瞬間、端末が PC と同じ LAN（Wi-Fi）に
  いる必要があります

v0.7.2 の変更
- 「センサー選択」の一覧が、直近のスキャンで実際に見つけた
  センサーだけを表示するようになりました。センサーを外したり
  範囲外に出たりすると、次に探した（または読み取った）時点で
  一覧から消えます。アプリの再起動は不要です。
- 選択中（使用中）のセンサーのボタンが緑色に塗られるように
  なりました。今どれが選ばれているか一目で分かります。

v0.7.1 の変更
- センサーごとに名前を付けられるようになりました（例：「布団の子」
  「外の子」）。名前は端末に保存され、アプリ画面の「センサー選択」
  の一覧（各センサーの「名前」ボタン）から付けられます。HTTP の
  set_sensor_label からも変更できます。
  名前は /status のセンサー一覧と読み取り結果（sensor_label）に
  表示されるので、MAC アドレスではなく名前で個体を呼べます。

v0.7.0 の変更
- センサーが2台ある環境で、読み取りが混ざる問題を修正しました。
  このセンサーは全台が同じ名前（Rbt…）で広告するため、2台が
  Bluetooth の範囲内にいると、従来は「先に見つけた方」を読んで
  しまい、読み取りのたびに2台の値が入れ替わることがありました。
  v0.7.0 では、スキャンで見つけた全台を把握したうえで、読む
  センサーを MAC アドレスで固定できるようになりました。
  固定はアプリ画面の「センサー選択」から（見つけたセンサーの
  一覧からタップで選択）、または HTTP の set_sensor から行えます。
  読み取り結果には sensor_mac（どのセンサーから読んだか）が
  付くようになりました。固定しない場合は従来どおり自動です
  （既知のセンサーを優先します）。

v0.6.9 の変更
- センサーログの設定を、アプリ画面からも変更できるようにしました。
  「センサーログ」の中に、間隔・記録期間・保存期間のセレクタ
  （タップするたびに候補が切り替わります）があります。変更は
  その場で保存され、次回の記録開始に使われます。記録中は設定を
  変更できません（停止中のみ変更できます。停止は記録中でも可能です）。
  従来どおり、HTTP の start_logging からも設定できます

v0.6.8 の変更
- センサーログ（端末側ロギング）：アプリ自体がセンサーを定期的に読んで、
  端末内に CSV ログを貯められるようになりました。外出先の空気の履歴を、
  あとから Muse がまとめて受け取れます。設定は3つです
  （間隔 10〜600秒／記録期間：手動停止まで・30分・1時間・3時間／
  保存期間：24時間・72時間・7日間）。HTTP の start_logging /
  stop_logging、またはアプリ画面の「センサーログ」から開始・停止でき、
  プロセスが再起動してもセッションは再開します。取得は GET /log.csv、
  傾向の要約は GET /log/summary.json です
- 撮影アシストの保留に有効期限（10分）を追加：前面に出られなかった等の
  理由で使われなかった撮影要求が、通知ごと自動で消えるようになりました
  （従来は再起動しても残り続けました）

v0.6.7 の変更
- 画面の整理（使い勝手の改善）：「サービス開始／停止」と
  「窓口を開く／閉じる」を、それぞれ状態で表示が切り替わる
  1つのボタンにまとめました。「電池の最適化を除外する」は
  除外済みの間は表示されません。蓄積データの操作とテスト系
  ボタンは、見出しタップで開く折りたたみの中に移しました

v0.6.5 の変更
- 状態の永続化：一部のタブレットでは、スリープ中に端末の電源管理が
  アプリのプロセスを再起動させることがあります。再起動で消えないよう、
  保留中の撮影要求と最新の写真を端末内に保存するようにしました
  （再起動すると、保留中の撮影の通知が出し直されます）
- 画面の整理：状態表示をカード風にし、操作をグループ見出しで
  分けました（動作は従来どおりです）

v0.6.4 の追加
- 撮影アシスト：端末によっては、アプリが前面にいる時しかカメラを
  開けないことがあります（裏では CAMERA_DISABLED や CAMERA_ERROR に
  なる）。その対策として、遠隔撮影の要求を通知経由で前面の撮影画面に
  渡す方式を追加しました。方式は3つから選べます
  （なし＝直接撮影／通知タップ＝通知をタップしたら撮影／
  フルスクリーン＝着信画面のように即座に撮影画面を出す）。
  アプリ画面のボタンか、HTTP の set_camera_assist で切り替えます
- 前面・背面カメラの選択：撮影時に facing=back / front を指定できます
  （前面カメラの写真は、写ったままの向きで渡します）

v0.6.3 の修正
- 写真の向き：一部の端末ではカメラが向き情報（EXIF）を写真に書かない
  ため、補正を写真データそのものの回転に変更しました。傾きの測定は
  加速度センサーのままです

v0.6.2 の修正
- 写真の向き：画面回転ではなく、加速度センサーで端末の実際の傾きを
  見て補正する方式に変更しました（手に持った時の向きに追随します）

v0.6.1 の修正（実機テストで見つかった点）
- 遠隔で機能を切り替えた時、電話画面のスイッチ表示も追随するようになりました
- 写真の向きを、撮影時の画面の回転に合わせて補正するようにしました
- 音声メモが Android の制限で開始できない問題に対応しました
  （フォアグラウンドサービスにマイク型を追加）
- バイブ合図で長さをミリ秒で指定できるようになりました（duration_ms）

機能は2グループに分かれています。

外の機器と Bluetooth でつなぐもの
- オムロン環境センサ 2JCIE-BU01 の値を表示し、HTTP で JSON 取得できます
（公式アプリの Android 版が配信終了したため製作しました）
- 心拍数ブロードキャスト受信：Bluetooth 標準の心拍プロファイル（0x180D）を
受信して表示・JSON 取得できます（Xiaomi Smart Band 11 で検証済み。
他の対応バンド／心拍センサーでも動作するはずです）

スマホ自体の力を使うもの（機能ごとに ON/OFF 切替つき）
- カメラ投稿：呼ばれた時だけ1枚撮影して渡すオンデマンド方式（常時撮影なし）
- 位置情報：呼ばれた時だけ現在地を取得（常時追尾なし）
- バイブ合図：Muse 側から通知ではなく直接スマホを震わせて知らせる合図
（短1回／短2回／長1回／注意パターンの4種）
- 音声メモ：最大60秒の短い録音を Muse 側から開始でき、取得できます
- バッテリー：残量と充電状態
- 歩数：端末の歩数センサーで「今日の歩数」を取得
（歩数センサーのない端末では未対応と表示されます）
- PCの起動：Wake-on-LAN のマジックパケットを送信して、登録した
PC をスリープから起こせます（v0.7.3。アプリ画面か HTTP から）

スマホ機能はすべて既定で OFF です。アプリ画面のスイッチ、または
HTTP の制御で機能ごとに ON/OFF できます。権限（カメラ・マイク・位置情報・
身体活動）は、対応する機能を ON にした時にだけ求めます。

HTTP 窓口（ポート 8766、主なもの）
- GET /status 状態（機能トグルの状態も含む）
- GET /features 機能ごとの状態と利用可否
- GET /read センサーを今すぐ読む（窓口が開いている時）
- GET /latest.json 最新のセンサー値
- GET /heartrate 最新の心拍数
- GET /log.csv センサーログ（端末側ロギングの CSV 履歴）
- GET /log/summary.json センサーログの傾向まとめ
- GET /device バッテリーと歩数
- GET /location 現在地（位置情報が ON の時）
- GET /photo?capture=1 その場で撮影して JPEG を返す（カメラ投稿が ON の時）
- GET /voice 最新の音声メモ（音声メモが ON の時）
- POST /control 窓口の開閉、記録制御、機能トグル、合図、録音開始など

インストール
- APK を Android 端末に入れてインストールしてください
（提供元不明アプリの許可が必要です）
- 初回はアプリを開いて「サービス開始」を押し、許可と電池最適化の
除外を設定してください

制限・注意
- センサーの読み取りは端末とセンサーが Bluetooth の届く範囲にある必要があります
- PCの起動（Wake-on-LAN）は、送信時に端末が PC と同じ LAN に
  いる必要があります。また PC 側の BIOS／OS の WoL 設定が前提です
- センサーログの記録は、アプリのプロセスが生きている間に進みます
  （通常はサービスがプロセスを保持します）。プロセスが再起動した場合は、
  記録期間内であればセッションが自動で再開します
- 歩数は端末に歩数センサー（TYPE_STEP_COUNTER）がある場合のみ使えます
- 写真・音声は端末内に「最新分だけ」を保持し、外部へ自動送信はしません
- 位置情報は端末や環境により誤差があります

免責
- オムロン公式・Xiaomi 公式とは関係のない個人製作です
- 動作保証はありません。自己責任でご利用ください

APK SHA-256: 33b7fb2225cf43932489d86a098f9d7eb59c50a179b0d687922c759a3cc890ef
