hisui inspect コマンド(開発者向け)

July 15, 2025 · View on GitHub

hisui inspect コマンドは、録画ファイルの詳細情報を取得するためのコマンドです。 このコマンドは主にデバッグやファイル分析に使用されます。

使用方法

$ hisui inspect -h
Recording Composition Tool Hisui

Usage: hisui ... inspect [OPTIONS] INPUT_FILE

Example:
  $ hisui inspect /path/to/archive.mp4

Arguments:
  INPUT_FILE 情報取得対象の録画ファイル(.mp4|.webm)

Options:
  -h, --help            このヘルプメッセージを表示します ('--help' なら詳細、'-h' なら簡易版を表示)
      --version         バージョン番号を表示します
      --verbose         警告未満のログメッセージも出力します
      --decode          指定された場合にはデコードまで行います
      --openh264 <PATH> OpenH264 の共有ライブラリのパス [env: HISUI_OPENH264_PATH]

実行例

録画ファイルを指定して実行すると、ファイルのパース結果が JSON 形式で出力されます。

$ hisui inspect /path/to/archive.mp4 | head
{
  "path": "/path/to/archive.mp4",
  "format": "mp4",
  "audio_codec": "OPUS",
  "audio_duration_us": 26960000,
  "audio_sample_count": 1348,
  "audio_samples": [
    { "timestamp_us": 0, "duration_us": 20000, "data_size": 3 },
    { "timestamp_us": 20000, "duration_us": 20000, "data_size": 3 },
    { "timestamp_us": 40000, "duration_us": 20000, "data_size": 3 },
...