CMSV6 API とビデオの統合: サードパーティのプラットフォームで使用できるもの

統合ガイド

サードパーティ プラットフォームは、データとアラーム用の HTTP API、ライブ ビデオ用のストリーム アドレス、ブラウザ用の Web プレーヤー プラグイン、アプリ用の iOS および Android SDK の 4 つの方法で CMSV6 を使用できます。 初期段階では 1 つの制限が重要です。RTSP、HTTP-FLV、HLS、および RTMP ライブ ストリームは H.264 のみをサポートします。 H.265 ビデオには Web プレーヤー プラグインが必要です。

デバイスが CMSV6 に到達する仕組み

車両デバイスは、JT/T 808 および JT/T 1078 経由で CMSV6 に接続します。JT/T 808 は、位置およびアラーム データを伝送します。 JT/T 1078 はビデオを伝送します。プラットフォームはデバイスと通信しません。 CMSV6 と通信し、CMSV6 がデータを公開します。のチェックリスト CMSV6 に接続できるデバイス 接続可能な機種の確認方法について説明します。モデルごとのインターフェースは各製品ページおよび見積書に記載されています。

HTTP API がカバーする内容

CMSV6 アカウントでサインインすると、セッション番号を受け取ります。他の呼び出しごとにそれが使用されます。セッションは 4 時間有効で、通話が継続している間は有効のままです。同じアカウントで 2 回目にサインインしても、最初のセッションは終了しません。セッションにはアカウントの役割と車両権限が付与されるため、API ユーザーには、そのアカウントが表示を許可されているデバイスのみが表示されます。

アラーム クエリは、お見積もり パラメータで選択された WGS84 (デフォルト)、Google (GCJ-02)、または Baidu (BD09) 形式で座標を返すことができます。アラーム検索には開始時刻と終了時刻が必要で、お見積もりあたり最大 90 日をカバーします。完全なリファレンスは次のとおりです。 HTTP API ヘルプセンターのセクション。

ライブビデオ: ストリームアドレス

CMSV6 は、別のプレーヤーまたはプラットフォームが開くことができるライブ ビデオ アドレスを返します。アドレスは、セッション番号、デバイス番号、チャネル (0 から数えます)、およびストリーム タイプ (メイン ストリームの場合は 0、サブ ストリームの場合は 1) から構築されます。

カメラが H.265 を送信する場合は、ブラウザーでライブ ビデオを表示するには、以下の Web プレーヤー プラグインを使用します。上記のストリーム アドレスは H.264 のみをサポートします。詳細は、 ビデオプロトコルの統合 セクション。

独自の Web アプリまたはモバイル アプリにビデオと地図を埋め込む

• ウェブプレーヤーのプラグイン。 JavaScript ファイルと WebAssembly デコーダにより、ライブ ビデオ、再生、双方向インターコム、ブロードキャストが PC およびモバイル ブラウザに追加されます。 H.264とH.265をサポートします。デコーダ ファイルはページの Web ルートに配置する必要があります。そうしないと、ビデオが黒のままになる可能性があります。 Vue 統合ガイドが含まれています。参照 ウェブビデオの統合。
• 既製の Web ページ。 サーバーは、単一車両のライブ ビデオとリモート再生のためのページを提供します。ページ アドレスでパラメータを渡します。画面上に 1 台の車両だけが必要な場合、これが最速のルートです。
• Web ページの統合。 パスワード不要のサインイン、リアルタイム位置情報ページ、およびトラック再生ページを自分のシステムから開くことができます。参照 Webページの統合。
• モバイルSDK。 ネイティブ iOS および Android SDK は、リアルタイムのオーディオとビデオ、双方向インターコム、リモート再生、ローカル デバイス検索をカバーします。参照 モバイルSDK。

どのルートを使用するか

データが到着したときにプラットフォームが画面上で行うことについては、を参照してください。 ライブビデオモニタリング、 トラックとビデオの再生 そして アラームのルールと処理。

独自のデバイスまたは ECU を構築する場合

CMSV6 ドキュメントでは、デバイスがプラットフォームにレポートする方法について説明しています。顧客独自のチップ上で AlwayCare ドライバー監視ソフトウェアを実行することについては説明されていません。この制限については、このセクションの最後で説明します。

接続方法は 2 つあります。 デバイスは、標準の JT/T 808 および JT/T 1078 プロトコルを介して接続することも、独自のデバイス側ネットワーク ライブラリとドキュメントを持つ CMSV6 プライベート プロトコルを介して接続することもできます。

接続するためにデバイスに必要なもの

• デバイス上の 3 つの設定: サーバーのパブリック IP アドレスまたはドメイン、レポート ポート、およびデバイス ID。プラットフォーム オペレーターはアドレスとポートを提供します。ドキュメントで説明されているプラ​​イベート プロトコル デバイス メニューでは、デフォルトのポートは 6608 です。独自のデプロイメントのポートを使用します。
• デバイス ID はプラットフォームと一致する必要があります。 JT/T デバイスは通常、12 桁のデバイス番号を使用します。番号が短い場合、プラットフォームは先頭にゼロを追加して 12 桁にします。デバイス ID は、プラットフォームがデバイスを認識するために使用する唯一のものです。
• プラットフォーム上に車両を追加します。 Quick Add Vehicle を使用して、デバイス ID、プレート番号、端末の種類、会社を入力します。未登録のデバイスを開くこともできます。そこに表示されるデバイスはすでにプラットフォームに接続されており、そのリストから車両に追加できます。
• ネットワークを確認してください。 制限されたネットワークまたは指定されたネットワーク上のデバイスは、1 つの固定サーバーにのみレポートできます。ネットワークでデバイスがプラットフォームに到達できることを確認します。

JT/T 808 および JT/T 1078 を介したドライバー監視および ADAS アラームのレポート

デバイスがアクティブ セーフティ アラーム (ドライバーの疲労や前方衝突警告など) を発する場合、写真やビデオを添付できます。プラットフォームは添付ファイルを要求し、デバイスはそれらを添付ファイル サーバーにアップロードします。順序は次のとおりです。

1. デバイスは、アクティブ セーフティ アラームとアタッチメントの数を含む位置データ (メッセージ 0200) を送信します。
2. プラットフォーム ゲートウェイは一般応答で応答し、添付ファイル サーバーのアドレスとポートを含むメッセージ 9208 を送信します。デバイスは一般的な応答を返します。アタッチメント サーバー ポートはデバイスから到達可能である必要があります。
3. デバイスは添付ファイル サーバーに接続し、メッセージ 1210 を送信します。サーバーは一般応答を送信します。
4. デバイスはメッセージ 1211 を添付データ ストリームと一緒に送信します。サーバーはこのメッセージに応答しません。
5. ファイルが完了すると、デバイスはメッセージ 1212 を送信し、サーバーは 9212 で応答します。
6. 次に、デバイスは次の添付ファイルをアップロードし、接続ステップからやり直します。

画像やビデオなしでアラームが到着した場合、ドキュメントでは、ゲートウェイ ログでデバイスからの 0200、プラットフォームからの 8001、プラットフォームからの 9208、デバイスからの 0001 のシーケンスを確認し、ファイルがストレージ サーバーに到達したかどうかを確認することを推奨しています。 808 および 1078 メッセージ用のログ解析ツールが提供されています。

アラームのタイプとプロトコルのバリエーション。 プラットフォームは、サポートするアクティブ セーフティ プロトコル タイプを、[操作]、[デバイス情報]、[追加]、[プロトコル タイプ] のデバイス情報フォームにリストします。この文書には、中国のいくつかの省および地域の予防安全基準 (江蘇、四川、広西、吉林、江西、陝西、上海、営口、重慶、浙江) のアラーム ID リストが含まれています。車両のアクティブ セーフティ プロトコル タイプが選択されると、プラットフォームはアクティブ セーフティ設定メニューから ADAS および DSM アラーム パラメータをデバイスに送信できます。プラットフォームに表示されるアラーム タイプは設定可能で、チェックされていないタイプは解析されません。

JT/T 808 の追加アラーム。 四川省グループの標準に基づいて、プラットフォームは、衝突、横転、開始、停止、SOS、および I/O アラームを報告するユーザー定義の拡張機能をサポートしています。

ビデオ録画のアップロード (JT/T 1078 のみ)。 ユーザーは、FTP によってデバイスから録音を取得するようにプラットフォームに要求できます。プラットフォームはメッセージ 9206 を送信し、デバイスは一般応答で応答してアップロードを開始し、アップロードが完了するとメッセージ 1206 を報告します。これは JT/T 1078 デバイスでのみ機能し、FTP サーバーはインターネットからアクセス可能である必要があります。

プライベート プロトコル: デバイスが実装するもの

プライベート プロトコルを使用するデバイスの場合、ドキュメントには次のタスクのデバイス側のコード例が記載されています。

• 写真やビデオでアラームを鳴らします。 デバイスは最初にアラームを報告し、アラーム番号を保持します。次に、そのアラーム番号を含む各ファイルをアップロードします。ファイルの種類は、JPEG 画像、録画、オーディオです。ビデオまたはオーディオ ファイルには長さが必要です。ピクチャの長さは 0 です。
• ビデオ形式。 デバイスは起動時にビデオ エンコーダーを宣言します。異なるチャネルでは異なるフォーマットが使用される場合があります。たとえば、あるチャネルでは H.264、別のチャネルでは H.265 が使用されます。 H.265 の場合、各 I フレームの前に VPS、SPS、および PPS がなければなりません。
• リモートアップグレード。 クライアントはアップグレード ファイルをサーバーにアップロードし、サーバーはそれをデバイスに送信します。オンライン デバイスのみをアップグレードできます。デバイスはバージョンをチェックし、ファイルを受信して​​検証し、再起動後にアップグレードします。ドキュメントでは、ストレージ カードなしでもデバイスをアップグレードできることを推奨しています。
• パラメータ設定。 ドキュメントでは、プラットフォームによって提供され、PC クライアントと Web クライアントの両方がロードする Web 設定ページを使用することを推奨しています。
• その他の文書化されたトピック。 オーディオ形式の統合、デバイスログのダウンロード、乗客数カウントデータ、デバイスの時間同期、およびメディアファイルを独自にアップロードするデバイス。

ドキュメントに記載されていないもの。 顧客自身の ECU または SoC 上で AlwayCare ドライバー監視ソフトウェアを実行することについては公開されていません。このドキュメントには、サポートされているチップやオペレーティング システム、メモリ、フラッシュやプロセッサの要件、カメラの組み合わせ、評価プロセスは記載されていません。独自のハードウェアに検出機能を組み込む予定がある場合は、エンジニアに質問を送信してください。 お問い合わせフォーム SoC、オペレーティング システム、カメラ センサー、メモリ、フラッシュなど、必要な機能を備えています。当社のエンジニアがお見積もりを評価します。

統合前に確認すべきこと

1. デバイス モデルとファームウェアが JT/T 808 および JT/T 1078 経由で接続されていることを確認します (上記のチェックリストを参照)。
2. 各カメラが H.264 または H.265 のどちらを送信するかを確認し、それをサポートするルートを選択します。
3. 必要なチャンネルと、メイン ストリームが必要かサブ ストリームが必要かをリストします。
4. CMSV6 を実行する場所を決定します。プラットフォームの認証は標準コンポーネントに記載されていますが、プラットフォーム ソフトウェアのコストは見積書に含まれていません。専用フリート サーバーの展開、カスタム API 統合、およびセルフホスト プラットフォーム ライセンスは、当社のエンジニアとの技術的な議論の後に利用可能です。
5. 独自のデバイスを構築する場合は、標準プロトコルまたはプライベート プロトコルを選択し、サーバー アドレス、ポート、デバイス ID を設定し、ゲートウェイ ログを使用してアラームと添付ファイルのフローをテストします。
6. 独自の展開のアドレスとアカウントを使用します。ドキュメントの例では、デモ サーバー アドレスとサンプル アカウントを使用しています。

カメラをプラットフォームに直接接続するか、CMSV6 を使用するかを選択する場合は、 AI ドライブレコーダーと既存のテレマティクス プラットフォームを統合する 統合パスを比較します。より広範なデータ接続リスクについては、以下をお読みください。 フリートデータサイロ。

完全なドキュメントを読む場所

CMSV6 ヘルプセンター: docs.alwaycare.com 英語と中国語でご利用いただけます。から始めてください HTTP API、 ビデオプロトコルの統合 そして ウェブビデオの統合 セクション。プラットフォーム自体については、 CMSV6 プラットフォームのページ。

CMSV6 統合に関する質問

プラットフォーム名、接続する予定のデバイス、および希望する統合ルートを、 お問い合わせフォームに該当するものを弊社エンジニアが確認させていただきます。

フリート管理、追跡、およびビデオ プラットフォームのオプションを 1 か所で確認するには、 フリート管理ソリューション。