Soracom

Users

ドキュメント

カメラ画像 (動画プレビュー) を確認する

S+ Camera シリーズ のカメラ画像 (動画) を SORACOM Mosaic コンソールで確認したり、S+ Camera シリーズ にリモートアクセスして動画を録画してダウンロードしたりできます。

動画プレビューのページを表示すると Napter の利用料金が発生します
SORACOM Mosaic コンソールの動画プレビュー機能は、自動的に Napter を利用して録画を開始したり動画を取得したりしています。そのため、SORACOM Mosaic コンソールの [動画] をクリックすると、Napter の利用料金が発生します。利用料金について詳しくは、SORACOM Napter のご利用料金 を参照してください。
動画プレビューはデータ通信量が多いため通信料金が高くなる傾向があります

当社実績: 解像度 1280 x 640 で撮影した場合、1 時間あたり約 1.4GiB のデータ通信量でした。

データ通信料金が気になる場合は、イベントハンドラー を利用して、IoT SIM のデータ通信量がしきい値を超えたときに IoT SIM を休止状態 (通信できない状態) にするなどの対策をご検討ください。

データ通信料金が発生します
動画の録画では、エッジコンピューターから SORACOM プラットフォームにアップロードするため、データ通信料金 が発生します。
S+ Camera Basic のカメラ画像 (動画) 撮影機能の制限
  • 再生される動画はリアルタイム映像ではありません。タイムラグが存在します。
  • 音声は録音されません。
  • S+ Camera シリーズ の内蔵カメラで動画を撮影します。背面の USB 端子に接続した USB 機器 は操作できません。
  • S+ Camera シリーズ 本体に保存可能な容量を超過した場合は、古い録画データから削除されます。
  • S+ Camera シリーズ のストレージに保存できる動画の長さは、カメラ画像の解像度 (横幅 x 高さ) により異なります。解像度 (横幅 x 高さ) の変更方法は、S+ Camera シリーズユーザーガイドの カメラの設定を確認/変更する を参照してください。
  • カメラ画像の解像度 (横幅 x 高さ) を変更すると、インストール済みのアルゴリズムで撮影される画像の解像度もあわせて変更されます。
  • 動画を画像解析に利用する場合の推奨解像度 (横幅 x 高さ) は 1280 x 720 です。
  • 動画プレビューおよび動画の録画機能で利用できるフレームレートは、25 FPS のみです。フレームレートの変更方法は、S+ Camera シリーズユーザーガイドの カメラの設定を確認/変更する を参照してください。

事前準備 

このページで説明する機能を利用する前に、以下の内容を確認してください。

SORACOM Mosaic アプリケーションを更新する 

動画プレビュー機能を利用するには、エッジコンピューターにインストールされている SORACOM Mosaic アプリケーションを更新する必要があります。詳しくは、SORACOM Mosaic アプリケーションを更新する を参照してください。

SORACOM Mosaic アプリケーションを更新すると、フレームレートが 25 未満に設定されていた場合は、自動的に 25 に設定されます。

イベントハンドラーを利用して IoT SIM の通信量を監視する 

イベントハンドラー を利用すると、以下のように IoT SIM の通信量を監視して IoT SIM を休止状態にしたり通知を受け取ったりできます。

データ通信量に応じた利用料金の見積もりを確認できます

S+ Camera シリーズ の場合は、SORACOM Air for セルラー の plan-D (データ通信のみ) を利用しています。データ通信量がわかる場合は、見積もりツールで利用料金の見積もりを確認できます。

見積もりツール にアクセスし、 [データ通信][plan-D][日中 (上り) KB] および [夜間 (上り) KB] にデータ通信量を入力します。

たとえば、S+ Camera シリーズ で日中に 1.4GiB (約 1 時間) の動画をプレビューした場合のデータ通信料金を確認するには、以下のように入力してください。

項目設定
SIM 枚数 (データ通信のみ)1
SIM 枚数 (データ通信/ SMS)0
利用日数1
速度クラスs1.4xfast (8 Mbps)
利用しているスピードクラスを選択してください。
日中 (上り) KB1468006
そのほかの項目0

各項目を設定すると、[データ通信料金 (税別)] にデータ通信料金が表示されます。また、[総額][総額 (税込)] に基本料金も含めた総額が表示されます。なお、利用料金について詳しくは、ご利用料金 – 特定地域向け IoT SIM (plan-D) を参照してください。

SORACOM Mosaic コンソールでカメラ画像 (動画プレビュー) を確認する 

SORACOM Mosaic コンソールで、最大 30 分間の動画プレビューを確認できます。

  1. SORACOM Mosaic コンソール にアクセスし、エッジコンピューターのデバイス ID をクリックします。

    img

    デバイス詳細画面の [概要] タブが表示されます。

  2. [スピードクラス][▼] をクリックし、「s1.4xfast」を選択します。

    img

  3. [動画] をクリックします。

    img

    Napter によるオンデマンドリモートアクセスが有効になり、エッジコンピューターで録画が始まります。

  4. [OK] をクリックします。

    動画プレビューが再生されます。

    img

  5. [概要][詳細] をクリックすると、録画が終了します。

動画プレビューの左下隅に表示されている一時停止ボタンをクリックしても、録画は継続しています。

リモートアクセスを利用してカメラ画像 (動画) をダウンロードする 

S+ Camera シリーズ が提供する API を外部から利用して、エッジコンピューターで録画開始および録画終了して、動画データを Mac OS、Linux、または Windows Subsystem for Linux (以下、PC) にダウンロードできます。

  1. エッジコンピューターへのリモートアクセスを有効にします。

    詳しくは、S+ Camera Basic が提供する API を外部から利用するためにリモートアクセスする場合 を参照してください。

  2. 以下のコマンドを実行して、URL を変数に代入します。

    ${surplusRemoteAccessURL} には、リモートアクセスを有効にしたときに [HTTP(S)] に表示された URL を入力してください。

    surplusRemoteAccessURLforDownloadMovie=${surplusRemoteAccessURL}
    
  3. 以下のコマンドを実行して、エッジコンピューターで録画を開始し、一定時間経過後に録画を終了します。

    playTime=15 # 動画データの時間 (秒)
    
    curl ${surplusRemoteAccessURLforDownloadMovie}/mosaic/v1/DeviceInterface/startCameraCapture # カメラ撮影有効化コマンド
    sleep 5 # 有効化後 2 秒以上待ってください
    curl ${surplusRemoteAccessURLforDownloadMovie}/mosaic/v1/DeviceInterface/startCameraRecording # 録画開始コマンド
    
    nowTime=$(date +%s)
    
    startTime=${nowTime}
    endTime=$((${startTime}+${playTime}))
    
    sleep ${playTime} # 録画を希望する時間だけ待ちます
    
    curl ${surplusRemoteAccessURLforDownloadMovie}/mosaic/v1/DeviceInterface/stopCameraRecording # 録画停止コマンド
    curl ${surplusRemoteAccessURLforDownloadMovie}/mosaic/v1/DeviceInterface/stopCameraCapture # カメラ撮影無効化コマンド
    
    startTime から endTime までを 600 秒未満にしてください。上記サンプルの場合は、playTime に 600 未満の数値を指定してください。
  4. 以下のコマンドを実行して、録画データの一部をダウンロードし、output.mp4 として保存します。

    ffmpeg -i "${surplusRemoteAccessURLforDownloadMovie}/mosaic/v1/LocalHarvestAgent/m3u8/${startTime}/${endTime}/index.m3u8" -c copy "output.mp4"
    
    startTimeendTime で指定した時間は目安です。ダウンロードできる動画データの開始時刻と終了時刻は、前後することがあります。
    ffmpeg version 4.3.1 で動作を確認しています。
S+ Camera Basic では録画予約を実現する API は提供していません
録画開始時刻に処理を実行してください。
S+ Camera シリーズ が提供する API について詳しくは、S+ Camera シリーズユーザーガイドの S+ Camera Basic が提供する API を参照してください。