JavaでGroupDocs.Metadataを使用してasfを抽出する方法

最新のメディアパイプラインでは、Javaでasfメタデータを抽出できることが、カタログ作成、コンプライアンス、そして自動処理に不可欠です。ASFコンテナを手動で解析するのはエラーが発生しやすく時間がかかりますが、GroupDocs.Metadata for Java は高レベルの API を提供し、重い作業を代行してくれます。このチュートリアルでは、ライブラリのインストール方法、コアプロパティの読み取り、コーデック情報へのアクセス、一般的な落とし穴の対処方法を順に解説し、どのJavaアプリケーションにも自信を持ってASFメタデータ抽出を組み込めるようにします。

クイック回答

  • “extract ASF metadata”とは何ですか？ それは、ASFファイルからタイムスタンプ、コーデック識別子、ストリーム記述子などの埋め込まれた情報をプログラムで読み取ることを意味します。
  • 必要なライブラリはどれですか？ GroupDocs.Metadata for Java（バージョン 24.12 以降）。
  • ライセンスは必要ですか？ 開発には無料トライアルまたは一時ライセンスで動作しますが、本番環境ではフルライセンスが必要です。
  • サポートされているJavaバージョンは？ JDK 8 以上。
  • Mavenを使用できますか？ はい – Maven が推奨の依存関係マネージャです。

asfメタデータとは？

ASF（Advanced Systems Format）メタデータは、ASFコンテナ内に保存された構造化タグの集合で、メディアファイルの技術的および記述的属性を記述します。これらのタグには作成タイムスタンプ、コーデック識別子、言語記述子、ビットレートや再生時間などのストリームレベルのプロパティが含まれます。プログラムでこのデータにアクセスすることで、検索可能なカタログの構築、コンプライアンス規則の適用、または自動トランスコーディングの判断が可能になります。

asfメタデータ抽出にGroupDocs.Metadata for Javaを使用する理由

GroupDocs.Metadata は 30 以上のオーディオ/ビデオ形式 をサポートし、ストリーミングアーキテクチャによりファイル全体をメモリに読み込むことなく 5 GB までのファイルを処理できます。ライブラリはクリーンなオブジェクトモデルを提供し、低レベルのバイト解析は不要です。そのため、数回のメソッド呼び出しだけでプロパティ、コーデック、記述子、ストリームの詳細を取得できます。これにより、カスタムパーサーを構築する場合と比較して開発工数が最大 70 % 削減されます。

前提条件

  • Java Development Kit (JDK) 8 以上がインストールされていること。
  • IDE（IntelliJ IDEA や Eclipse など）を使用するとコーディングが便利です。
  • Maven が IDE で設定されていること（任意ですが推奨）。
  • Java と外部ライブラリに関する基本的な知識。

GroupDocs.Metadata for Java の設定

GroupDocs.Metadata for Java の設定方法は？

pom.xml に GroupDocs リポジトリと依存関係を追加します。この一手順でプロジェクト全体で API が利用可能になります。

<!-- Maven repository -->
<repositories>
    <repository>
        <id>groupdocs-maven</id>
        <url>https://repo.groupdocs.com/maven</url>
    </repository>
</repositories>

<!-- GroupDocs.Metadata dependency -->
<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>metadata</artifactId>
    <version>24.12</version>
</dependency>

GroupDocs.Metadata JAR は Maven ビルド時に自動的に解決されます。

直接ダウンロード（Mavenなし）

Maven を使用したくない場合は、GroupDocs.Metadata for Java releases から最新の JAR をダウンロードしてください。JAR をクラスパスに配置すればすぐに使用できます。

ライセンス概要

  • 無料トライアル – 評価のために機能制限なしで利用可能；ウォーターマークなし。
  • 一時ライセンス – 開発や自動テストに最適。
  • フルライセンス – 商用展開およびプレミアムサポートの利用に必要。

基本的な初期化

Metadata クラスはファイルをロードし、フォーマット固有のアクセサーを提供するエントリーポイントです。以下は ASF ファイルを開くために必要な最小限のコードです。

import com.groupdocs.metadata.Metadata;

class MetadataExample {
    public static void main(String[] args) {
        try (Metadata metadata = new Metadata("YOUR_DOCUMENT_DIRECTORY/input.asf")) {
            // Your code for accessing metadata properties will go here.
        }
    }
}

基本的な ASF メタデータプロパティの抽出方法

ASF ファイルをロードし、作成日、ファイル識別子、グローバルフラグなどの高レベルプロパティを取得します。これにより、アセットがいつ作成されたか、再生時にどのようにフラグ付けされているかをすぐに把握できます。

// Load the ASF file
AsfPackage asf = new AsfPackage("sample.asf");

// Retrieve basic properties
Date creationDate = asf.getCreationDate();
String fileId = asf.getFileId();
int flags = asf.getFlags();

重要性: 作成日を把握することでバージョン管理に役立ち、ファイル ID は分散システム全体でアセットを一意に識別します。

ASF コーデック情報の表示方法

AsfCodecInfo コレクションは、オーディオおよびビデオストリームで使用される各コーデックを列挙します。getCodecs() メソッドは、コーデック名、タイプ、ビットレートを公開するオブジェクトを返します。コーデックの使用状況を把握することは、互換性テスト、トランスコーディングの必要性判断、対象デバイスがエラーなくストリームをデコードできるか確認する上で重要です。

// Get codec collection
List<AsfCodecInfo> codecs = asf.getCodecs();

for (AsfCodecInfo codec : codecs) {
    System.out.println("Codec name: " + codec.getName());
    System.out.println("Codec type: " + codec.getType());
}

重要性: コーデックの詳細により、対象デバイスが必要なフォーマットをサポートしているか確認でき、本番環境での再生失敗を防げます。

メタデータ記述子の表示方法

記述子は、言語、元のタイトル、ストリーム番号などの人間が読めるコンテキストを提供します。getDescriptors() メソッドを使用して AsfDescriptor オブジェクトのリストを取得します。各オブジェクトはキー、値、オプションの言語タグを含みます。このデータは検索インデックスを強化し、UI 表示を改善し、多言語ライブラリの整理に役立ちます。

// Retrieve descriptor collection
List<AsfDescriptor> descriptors = asf.getDescriptors();

for (AsfDescriptor descriptor : descriptors) {
    System.out.println("Language: " + descriptor.getLanguage());
    System.out.println("Original title: " + descriptor.getOriginalTitle());
}

重要性: 記述子により、字幕の言語や元のファイル名が分かり、多言語メディアライブラリの整理に有用です。

基本ストリームプロパティの表示方法

基本ストリームプロパティは、ストリームごとのビットレート、タイミング、言語を公開し、細かな品質分析を可能にします。getStreams() メソッドは AsfStream オブジェクトを返し、各ストリームは bitrate、duration、language などのプロパティを含みます。これらの値を検査することで、配布やアーカイブ前にファイルが品質基準を満たしているか評価できます。

// Access base streams
List<AsfBaseStream> streams = asf.getBaseStreams();

for (AsfBaseStream stream : streams) {
    System.out.println("Bitrate: " + stream.getBitrate());
    System.out.println("Duration: " + stream.getDuration());
    System.out.println("Language: " + stream.getLanguage());
}

重要性: ストリームレベルの指標により、配布やアーカイブ前にファイルが品質基準を満たしているか評価できます。

よくある問題とトラブルシューティング

症状考えられる原因対策
getAsfPackage() 呼び出し時の NullPointerExceptionファイルパスが間違っているか、ファイルが有効な ASF コンテナではありません。パスを確認し、ファイルが正しい ASF ファイルであることを確認してください。
コーデック情報が表示されないASF ファイルが現在のライブラリバージョンで認識されない独自コーデックを使用しています。GroupDocs.Metadata を最新リリースに更新するか、カスタムコーデックパーサーを実装してください。
記述子リストが空ファイルに埋め込み記述子がありません（例：エンコード時に除去された）。メタデータ付きのソースファイルを使用するか、メタデータ保持を有効にして再エンコードしてください。
2 GB 超のファイルでパフォーマンス低下デフォルトのバッファサイズが大きなストリームに対して小さすぎます。MetadataLoadOptions.setBufferSize() でロード前にバッファサイズを増やしてください。

よくある質問

Q: 同じライブラリで他のビデオ形式のメタデータも抽出できますか？
A: はい、GroupDocs.Metadata は MP4、MKV、AVI、MOV など多数をサポートしています。必要な形式に対応するパッケージクラスをインスタンス化するだけです。

Q: 抽出後に ASF メタデータを変更できますか？
A: もちろんです。ライブラリはほとんどのプロパティに対する setter メソッドを提供しており、値を編集してファイルをディスクに保存できます。

Q: 大きな ASF ファイルのために 64 ビット JVM が必要ですか？
A: 必要ではありませんが、64 ビット JVM はヒープサイズが大きくなるため、2 GB 超のファイルを処理する際に有利です。

Q: ライセンスはトライアル使用にどのように影響しますか？
A: トライアルライセンスは機能制限を解除しますが、特定のエクスポート操作にウォーターマークが付加されます。制限なしの本番利用にはフルライセンスを購入してください。

Q: このコードを Android デバイスで実行できますか？
A: GroupDocs.Metadata は Java SE 向けに構築されています。Android では Xamarin などの .NET バージョンや互換ラッパーを使用してください。

結論

このガイドに従うことで、GroupDocs.Metadata を使用した Javaでのasfメタデータ抽出方法 が分かりました。基本プロパティの読み取り、コーデックの列挙、詳細な記述子の取得、ストリームレベル属性の検査が可能になり、メディア資産を完全に把握できます。次のステップとして、バッチ処理パイプラインへの組み込み、検索可能なメタデータストアの構築、またはコードを拡張して ASF ファイルを変更・再保存することが考えられます。

最終更新日: 2026-09-02
テスト環境: GroupDocs.Metadata 24.12 for Java
作者: GroupDocs

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/metadata/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-metadata</artifactId>
      <version>24.12</version>
   </dependency>
</dependencies>

import com.groupdocs.metadata.Metadata;
import com.groupdocs.metadata.core.AsfRootPackage;

class ReadBasicProperties {
    public static void main(String[] args) {
        try (Metadata metadata = new Metadata("YOUR_DOCUMENT_DIRECTORY/input.asf")) {
            AsfRootPackage root = metadata.getRootPackageGeneric();
            com.groupdocs.metadata.core.AsfPackage asfPackage = root.getAsfPackage();

            System.out.println("Creation date: " + asfPackage.getCreationDate());
            System.out.println("File id: " + asfPackage.getFileID());
            System.out.println("Flags: " + asfPackage.getFlags());
        }
    }
}

import com.groupdocs.metadata.core.AsfCodec;

class ReadCodecInformation {
    public static void main(String[] args) {
        try (Metadata metadata = new Metadata("YOUR_DOCUMENT_DIRECTORY/input.asf")) {
            AsfRootPackage root = metadata.getRootPackageGeneric();
            com.groupdocs.metadata.core.AsfPackage asfPackage = root.getAsfPackage();

            for (AsfCodec codecInfo : asfPackage.getCodecInformation()) {
                System.out.println("Codec type: " + codecInfo.getCodecType());
                System.out.println("Description: " + codecInfo.getDescription());
                System.out.println("Codec information: " + codecInfo.getInformation());
                System.out.println(codecInfo.getName());
            }
        }
    }
}

import com.groupdocs.metadata.core.AsfBaseDescriptor;
import com.groupdocs.metadata.core.AsfMetadataDescriptor;

class ReadMetadataDescriptors {
    public static void main(String[] args) {
        try (Metadata metadata = new Metadata("YOUR_DOCUMENT_DIRECTORY/input.asf")) {
            AsfRootPackage root = metadata.getRootPackageGeneric();
            com.groupdocs.metadata.core.AsfPackage asfPackage = root.getAsfPackage();

            for (AsfBaseDescriptor descriptor : asfPackage.getMetadataDescriptors()) {
                System.out.println("Name: " + descriptor.getName());
                System.out.println("Value: " + descriptor.getValue());
                System.out.println("Content type: " + descriptor.getAsfContentType());

                if (descriptor instanceof AsfMetadataDescriptor) {
                    AsfMetadataDescriptor metadataDescriptor = (AsfMetadataDescriptor) descriptor;
                    System.out.println("Language: " + metadataDescriptor.getLanguage());
                    System.out.println("Stream number: " + metadataDescriptor.getStreamNumber());
                    System.out.println("Original name: " + metadataDescriptor.getOriginalName());
                }
            }
        }
    }
}

import com.groupdocs.metadata.core.AsfBaseStreamProperty;

class ReadBaseStreamProperties {
    public static void main(String[] args) {
        try (Metadata metadata = new Metadata("YOUR_DOCUMENT_DIRECTORY/input.asf")) {
            AsfRootPackage root = metadata.getRootPackageGeneric();
            com.groupdocs.metadata.core.AsfPackage asfPackage = root.getAsfPackage();

            for (AsfBaseStreamProperty property : asfPackage.getStreamProperties()) {
                System.out.println("Alternate bitrate: " + property.getAlternateBitrate());
                System.out.println("Average bitrate: " + property.getAverageBitrate());
                System.out.println("Average time per frame: " + property.getAverageTimePerFrame());
                System.out.println("Bitrate: " + property.getBitrate());
                System.out.println("Stream end time: " + property.getEndTime());
                System.out.println("Stream flags: " + property.getFlags());
                System.out.println("Stream language: " + property.getLanguage());
                System.out.println("Stream start time: " + property.getStartTime());
                System.out.println("Stream number: " + property.getStreamNumber());
            }
        }
    }
}

関連チュートリアル