接続情報​

  • ホスト: 中国ステーション: sensecap-openstream.seeed.cn グローバルステーション: sensecap-openstream.seeed.cc
  • ポート: MQTTの場合は1883、MQTT Over WebSocketの場合は8083
  • ClientID: org-<Organization ID>-<Random ID>、<Organization ID>をSenseCAPポータルから取得したものに置き換え、<Random ID>をランダムに生成した数字と小文字の英字に置き換えてください。
  • Username: org-<Organization ID>、<Organization ID>をダッシュボードから取得したものに置き換えてください（クイックスタートを参照）。
  • Password: SenseCAPポータルの「セキュリティ / APIアクセスキー」でAPIキーを取得してください（クイックスタートを参照）。

パブリッシュ＆サブスクライブモデル​

SenseCAP OpenStream APIはMQTTプロトコルと同様に「パブリッシュ＆サブスクライブモデル」を実装しています。MQTTまたはMQTT Over WebSocketを介してSenseCAP OpenStream APIにサーバーを接続し、標準的なパブサブプロトコルで通信することができます。

「サブスクライブ」を使用してメッセージを受信することができます。「サブスクライブ」はデバイスからのテレメトリーデータを継続的に監視する最も一般的な方法です。

メッセージトピック​

デバイスの測定データを受信する​

トピック形式: /device_sensor_data/<OrgID>/<DeviceEUI>/<Channel>/<Reserved>/<MeasurementID>
フィールド説明
OrgIDあなたの「Organization ID」。SenseCAPポータルで確認できます。ユニークなOrganization IDを所有しており、すべてのトピックに必要です。
DeviceEUIデバイスのユニークな識別子
Channelセンサーが接続されるデバイス上の物理ソケット
Reserved予約済み
MeasurementIDこのドキュメントの「測定IDのリスト」を参照してください
トピックはフィルタリング条件を指定して、特定のデバイス、チャネル、測定タイプをリスニングすることを実現できます。例えば、デバイスIDが「2F000000000000」のデバイスのみをリスニングしたい場合、<DeviceEUI>フィールドを2F000000000000に置き換えることができます。

この例の「2F000000000000」は、すでにアカウントにバインドされているデバイスである必要があります。また、<OrgID>を必ず自分の「Organization ID」に置き換える必要があります。

メッセージ本文​

{
    "value": "437",
    "timestamp": "1544151922137"
}

これはデバイスによってアップロードされたセンサー測定データであり、JSON形式に準拠しており、JSONパーサーで解析可能です。一般的に、ほとんどの機能要件では、本文はトピック内のいくつかのフィールドと組み合わせて使用する必要があります。

フィールド説明
valueセンサーの測定値
timestampデータの収集タイムスタンプ（単位: ミリ秒）

デバイスのステータスデータを受信する​

トピック形式: /device_status_event/<OrgID>/<DeviceEUI>/<Reserved>/<StatusID>
フィールド説明
OrgIDあなたの「Organization ID」。SenseCAPポータルで確認できます。ユニークなOrganization IDを所有しており、すべてのトピックに必要です。
DeviceEUIデバイスのユニークな識別子
Reserved予約済み
StatusIDこのドキュメントの「デバイスステータスIDのリスト」を参照してください
必要なStatusIDをデバイスステートIDのリストに従ってサブスクライブし、予期しないIDをサブスクライブしないようにしてください。

メッセージ本文​

{
    "value": "437",
    "timestamp": "1544151922137"
}
フィールド説明
valueセンサーのステータス値
timestampデータの収集タイムスタンプ（単位: ミリ秒）