Nature Remo はCloud APIを使って様々な操作をプログラムすることができます。ここでは、明るさセンサーの現在値を読むショートカットを解説します
ショートカット
Remoから明るさセンサーの現在値を読むショートカットを示します
ショートカットの構成
このショートカットは
- Remoのcloud APIに現在値リクエストを送る
- 返ってきたJSON情報を解析して明るさの値を取り出す
1.クリップボードに値をコピーする( 呼び出した別のショートカットに渡すため)
という3つのサブタスクで構成しています
Remoのcloud APIに現在値リクエストを送る
「【Nature Remo】APIの利用例まとめ」などにあるようにPC(Mac, Windows, Linux)からはcurlコマンドで情報を取得、操作します。次のコマンドで
$ curl -X GET "https://api.nature.global/1/devices" -H "accept: application/json" -H "Authorization: Bearer XXXXXXXX"
XXXXXXXXはアクセストークン（トークンの取得方法は→こちらのページなど）
自分のリモコンの現在の状態が次のJSON形式で得られるので、その中から明るさ情報を取り出します。
[{"name":"Remo",
"id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"created_at":"2021-07-29T23:58:16Z",
"updated_at":"2023-04-30T00:06:13Z",
"mac_address":"xx:xx:xx:xx:xx:xx",
"bt_mac_address":"xx:xx:xx:xx:xx:xx",
"serial_number":"XXXXXXXXXXXXXX",
"firmware_version":"Remo/1.6.4",
"temperature_offset":0,
"humidity_offset":0,
"users":[{
"id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"nickname":"XXXXXX",
"superuser":true}],
"newest_events":{
"hu":{"val":71,
"created_at":"2023-04-30T01:15:46Z"},
"il":{"val":97,
"created_at":"2023-04-30T01:21:59Z"},
"mo":{"val":1,
"created_at":"2023-04-30T00:38:07Z"},
"te":{"val":22.8,
"created_at":"2023-04-30T01:21:46Z"}}}]
明るさ情報は"il"(illumination)タグの"val"の値なので、"newest_events"/"il"/"val" の値を取り出します。
この処理は
［URL/｛https://api.nature.global/1/devices｝］ (1)
URLアクションでAPIのURLを設定し
[{URL}の内容を取得/
方法： GET
ヘッダ：
accept: application/json
Authorization: Bearer XXXXXXXX"] (2)
URLの内容を取得アクションでcurlコマンドを実行してリクエストを送信します。curlの引数やオプションの文字列はそれぞれのアクションのパラメータに記述します。curlの２つの-Hオプションは「ヘッダ」の２つのパラメータとなります。Authorizationタグの値は文字列"Bearer"にスペースを入れて、前に取得したアクセストークンの値を入れます。このアクションの{URL}に直接URL文字列（https://...）を入力する例を示す記事もありましたが、うまく動作しませんでしたので、一度URLアクションにURL文字列を入力する形にしました。
返ってきたJSON情報を解析して明るさの値を取り出す
［リストから項目を取得/｛URLの内容｝から{最初の項目}を取得］ (3)
curlリクエストでAPIから返ってきた文字列全体が｛URLの内容｝で一般的には複数の項目が帰ってくる場合もあるので{最初の項目}で一つを取り出します。今回の場合は一つしか返ってこないので
、同じものです。
[辞書の値を取得 / {リストからの項目}内の{newest_events.il.val}の{値}を取得] (4)
取り出したJSON文字列から順にnewest_events/il/valの値を読み出します。キーを階層的に記述することで１回のアクションで読みだせます。この値が現在の部屋の明るさを示す数値です。照明を消したりして変化することを確認してみてください。値に反映されるのに少し時間がかかります（数秒）
クリップボードに値をコピーする
このショートカットをサブルーチンとして別のショートカットから利用するため明るさの値をクリップボードにコピーします。（別のショートカットに値を渡すスマートな方法をご存じの方、教えてください）
[クリップボードにコピー / {辞書の値}をクリップボードにコピー] (5)
このスクリプトを使って、現在の部屋の明るさに応じて動作するショートカットを作ることができます