Soracom

Enterprise ボタンのボタンをクリックしたときに、クリック種別、バッテリ残量などのデータを Beam を利用して任意のサーバーに転送できます。ここでは、Postman のモックサーバーに転送します。Postman のモックサーバーは、URL を発行して、その URL に送信した HTTP リクエストをブラウザで確認できる Web サービスです。

ステップ 1: 転送先として Postman のモックサーバーを作成する

このページで説明する機能を体験するために、転送先として Postman のモックサーバーを作成します。操作手順について詳しくは、モックサーバーを作成する を参照してください。

ステップ 2: Beam を設定する

1. ユーザーコンソール にログインし、カバレッジタイプを「日本」に変更します。

2. [メニュー] → [ガジェット管理] → [LTE-M Button for Enterprise] の順にクリックします。

   

3. Beam を設定する Enterprise ボタンにチェックを入れて、[SIM グループを編集] をクリックします。

   

4. [SORACOM Beam 設定] → [＋設定を追加する] の順にクリックします。

   

5. [UDP → HTTP/HTTPS エントリポイント] をクリックして、以下の項目を設定します。

   項目	説明
   [設定名]	任意の名前を入力します。例: UDPToHTTP
   [有効]	この設定を有効化します。
   [転送先] → [プロトコル]	「HTTPS」を選択します。
   [転送先] → [ホスト名]	モックサーバーの URL から「https://」を除いた部分を入力します。例: 12345678-90ab-cdef-1234-567890abcdef.mock.pstmn.io
   [転送先] → [ポート番号]	空欄のままにします。
   [転送先] → [パス]	「/」と、モックサーバーの [リクエスト URL] に入力した文字列を入力します。例: /action
   [ヘッダ操作] → [SIM ID ヘッダ]	どの GPS マルチユニットからのデータかを、転送先のサーバーで識別するために、オンにします。
   [レスポンス] → [ステータスコードを省略]	オフのままにします。Enterprise ボタンはレスポンスボディが 2 で始まると成功とみなし、それ以外を失敗とみなします。

   

6. [保存] をクリックします。

7. [SORACOM Beam 設定] → [転送先] にモックサーバーのエンドポイントが表示されていることを確認します。

   

ステップ 3: ボタンをクリックしてモックサーバーでデータを確認する

1. ボタンをシングルクリックします。

   LED が約 10 秒間オレンジで点滅したあと、約 3 秒間緑色に点灯します。

   緑色に点灯しない場合は

   • 約 5 秒間赤色に点灯した場合は、基地局との接続に失敗しています。電波状況の良いところで再度試してください。
   • 約 5 秒間赤色に点滅した場合は、電池残量が不足しています。電池を交換してください。

2. 緑色に点灯した場合は、転送先に設定したモックサーバーで、呼び出しログを確認します。

   操作手順について詳しくは、呼び出しログを確認する を参照してください。

   特に、以下のデータを確認してください。

   項目	説明
   [リクエストヘッダー]	x-soracom-sim-id: Enterprise ボタンの IoT SIM の SIM ID です。 x-soracom-geo-position: 簡易位置測位機能 を有効にした場合の、緯度および経度です。 緯度;経度 のフォーマットで。緯度は -90 ~ 90、経度は -180 ~ 180 です。
   [リクエストボディ]	clickType: クリックの 3 つのタイプ (数値)。以下のいずれかです。 1: シングルクリック。 2: ダブルクリック。 3: 長押し。 clickTypeName: クリックの 3 つのタイプ (文字列)。以下のいずれかです。 SINGLE: シングルクリック。 DOUBLE: ダブルクリック。 LONG: 長押し。 batteryLevel: バッテリーレベル。以下のいずれかです。 0.25、0.5、0.75、1.0 binaryParserEnabled: バイナリパーサー の有効/無効。 true: 有効。 false: 無効。

ステップ 4: (任意) 位置情報を送信する

簡易位置測位機能を有効にすると、x-soracom-geo-position ヘッダーに 緯度;経度 の形式で Enterprise ボタンの緯度と経度が挿入されます。

1. LTE-M Button for Enterprise/Plus 画面 を表示します。

2. 位置情報を送信する Enterprise ボタンにチェックを入れ、[デバイス設定変更] をクリックします。

   

3. [位置情報を付与する (簡易位置測位機能)] にチェックを入れ、[保存] → [デバイス一覧に戻る] の順にクリックします。

   

4. ステップ 3: ボタンをクリックしてモックサーバーでデータを確認する の手順を行い、[リクエストヘッダー] の x-soracom-geo-position を確認します。