ソラコム公式ブログ

クラウドカメラの映像を自由にコントロール〜ソラカメ API・Webコンソールの一般公開〜

2022年10月06日 17時00分更新

　本記事はソラコムが提供する「SORACOM公式ブログ」に掲載された「クラウドカメラの映像を自由にコントロール〜ソラカメ API・Webコンソールの一般公開〜」を再編集したものです。

ソラカメ API とは？活用のポイント
ソラカメの API について
カメラ情報取得 API
ライブ映像ストリーミング再生 API
録画映像ストリーミング再生 API
録画映像ダウンロード API
静止画ダウンロード API
ソラカメ APIの利用について
あとがき～ソラカメ APIでクラウドカメラの可能性を広げます！

こんにちは、ソラコムでソラカメのプロダクトマネージャをしている五十嵐 (ニックネーム: ash )です。

本日は、カメラ映像をクラウドへ常時録画・再生できる Soracom Cloud Camera Services「ソラカメ」のアップデートをお届けいたします。

ソラカメの映像はスマートフォンのアプリを通して簡単に録画された映像を見ることができるため、今年5月の発売以来、たいへんご好評をいただいております。一方で、ソラカメをスマートフォンのアプリだけではなく、「映像をAIで活用したい」「自社システムと連携したい」というお声を多数いただき、2022 年 7 月よりソラカメ API を Limited Preview として提供してまいりました。

本日ソラカメ API は Limited Preview を卒業し、一般公開となりました。ソラカメのライセンスをお持ちの方であれば、すぐにソラカメAPIをご利用いただけます。

ソラカメ API とは？活用のポイント

ソラカメはスマートフォンのアプリを通して現在の状況や、クラウドに常時録画された過去の映像を簡単に閲覧することができます。昨今では、カメラ映像をAIで解析して判断や自動化に使うケースが増えています。ソラカメに対しても「撮影した映像や静止画を活用したい」といったニーズをお寄せいただいていました。

そんな場合に活躍するのがソラカメ API です。
ソラカメ API を利用すると、ソラカメのライブ映像やクラウド上の録画映像、録画されている任意の時間の静止画を自由に取り出すことができます。取り出した映像を、他システムやサービスと連携させたり、解析したりして、自社のシステムに組み込むなど、新しい付加価値をつけて、新たなソリューションを創り出すことが可能です！

また、Webブラウザ上でAPIの利用体験ができる「 Web コンソール」も同時に公開しています。API って聞くとなんだか難しそうとお感じになられる方もご安心ください。どなたでも、ソラカメ APIを簡単にご利用いただけます。

ソラカメの API について

提供を開始したソラカメ APIは、以下の通りです。

カメラ情報取得 API
ライブ映像ストリーミング再生 API
録画映像ストリーミング再生 API
録画映像ダウンロード API
静止画ダウンロード API

カメラ情報取得 API

カメラに関する情報が取得できます。具体的には、次の情報が得られます。

名前：カメラに設定した名前
状態：カメラの接続情報
最終接続日時：カメラが Online になった時間
ファームウェアバージョン：カメラのファームウェアのバージョン情報
製品名：カメラの種類（ATOM Cam 2、ATOM Cam Swing）
デバイス ID：デバイスの識別子

カメラの動作状況確認や遠隔管理だけでなく、複数台のカメラを管理する際に利用できます。例えば基幹システムに「デバイスID」を記録しておき、カメラの状態をAPIで取得して基幹システム上に表示できます。

ライブ映像ストリーミング再生 API

現在のカメラ映像を、ストリームとして取得できます。
ストリームは MPEG-DASH 形式です。パソコンの動画プレーヤ（例：VLC Media Player）で再生したり、dash.js のようなライブラリを用いることによって、Web アプリケーションへ組み込めます。

例えば地図画像を背景にしたWebページ上で「各地点の今」が一覧できるシステムを構築できます。
※映像の公開範囲にはご注意ください。また、再生可能時間の制約があります。詳しくは本ブログの最後「ソラカメ APIの利用について」をご覧ください。

録画映像ストリーミング再生 API

クラウド上の録画済み映像を、ストリームとして取得できます。
希望する動画の開始時刻と終了時刻を指定すると、ストリームが取得できます。ストリームの仕様は、ライブ映像ストリーミング再生 APIと同じです。

利用例としては、倉庫管理システムの在庫の入出庫時刻と照らし合わせて、当時の作業振り返りに利用できるでしょう。

録画映像ダウンロード API

クラウド上に録画済みの映像を、mp4 形式の動画ファイルとして取得できます。
希望する動画の開始時刻と終了時刻を指定すると、mp4ファイルがパッケージされたZIPファイルがダウンロードできます。期間の指定によっては、ZIPファイル内に複数のmp4ファイルがアーカイブされます。

入手したmp4ファイルは、クラウド上のAI/機械学習エンジンと連携させることができます。また、単純に記録として外部システムへ保存も可能です。

静止画ダウンロード API

希望する動画の時刻を指定すると、静止画が取得できます。
静止画は JEPG 形式です。解像度は録画当時の設定に依存します。例えば、HDで記録している期間であればHD（1280×720ピクセル）のJPEGファイルがダウンロードできます。また、取得指示の際には、ATOM Cam シリーズの広角レンズに起因する画像のゆがみ補正をAPI側で実施するオプションが指定できます。