Camera - masaru-takano/DeviceConnect-Spec GitHub Wiki

概要

スマートデバイス(Cameraデバイスなど)のズーム操作機能を提供するAPI。

目次

API 概要
GET /gotapi/camera/zoom Cameraデバイスの現在の倍率を取得する。
PUT /gotapi/camera/zoom Cameraデバイスに対してレンズのズームイン・アウトリクエストを送る。

種別

one-shot

概要

Cameraデバイスの現在の倍率を取得する。

リクエスト

物理名 データ型 必須 説明
serviceId string Yes サービスID。取得対象スマートデバイス

レスポンス

物理名 データ型 必須 説明
result integer Yes 処理結果
0: 正常応答
0以外: 異常応答
product string Yes DeviceConnectシステムの名前
version string Yes DeviceConnectシステムのバージョン名
zoomPosition float Yes カメラの倍率
カメラの倍率(%)
例)
QX-10の場合
0(%):拡大なし
50(%):倍率5倍での拡大
hmac string No レスポンスに対する署名
アプリケーション側から事前にHMACキーを共有されていた場合は必須。

レスポンスサンプル

{
  "result" : 0,
  "product" : "Example System",
  "version" : "1.0.0",
  "zoomPosition" : 0
}

種別

one-shot

概要

Cameraデバイスに対してレンズのズームイン・アウトリクエストを送る。

リクエスト

物理名 データ型 必須 説明
serviceId string Yes サービスID。取得対象スマートデバイス
direction string Yes 方向。ズームの方向
in
out
movement string Yes 動作。ズームの動作
in-startで開始して in-stopで終了。
1shotは開始してから所定位置まで動作する。
maxはin-startと同じ動作を行う。

レスポンス

物理名 データ型 必須 説明
result integer Yes 処理結果
0: 正常応答
0以外: 異常応答
product string Yes DeviceConnectシステムの名前
version string Yes DeviceConnectシステムのバージョン名
hmac string No レスポンスに対する署名
アプリケーション側から事前にHMACキーを共有されていた場合は必須。

レスポンスサンプル

{
  "result" : 0,
  "product" : "Example System",
  "version" : "1.0.0"
}
⚠️ **GitHub.com Fallback** ⚠️