يتم إرفاق متغيرات البيانات الوصفية بمستندات ذات تنسيقات ملفات مختلفة. تحتوي ملفات MP3 عادةً على علامات بيانات تعريف ID3. تتناول هذه المقالة كيفية قراءة علامات MP3 المختلفة في Java. سنرى كيفية استخراج ID3 (IDEv1 و ID3v2) و Lyrics و APEv2 metadata من ملفات mp3 باستخدام Java Metadata API واحدًا تلو الآخر.

يتم تناول الموضوعات التالية أدناه:

Java API لعلامات البيانات الوصفية MP3

تم تجهيز [GroupDocs.Metadata] (https://products.groupdocs.com/metadata) بواجهات برمجة التطبيقات لأتمتة إدارة البيانات الوصفية لـ [تنسيقات الملفات المختلفة] (https://docs.groupdocs.com/metadata/net/supported-document -التنسيق /) داخل التطبيقات. تسمح لك Java API بقراءة البيانات الوصفية وتحديثها وإضافتها وتنظيفها وإزالتها للعديد من تنسيقات الملفات داخل تطبيق Java. سنستخدمها للعمل مع علامات البيانات الوصفية MP3.

التنزيل والتكوين

احصل على مكتبة البيانات الوصفية من قسم [التنزيلات] (https://downloads.groupdocs.com/metadata/java). بالنسبة إلى تطبيق Java المستند إلى Maven ، ما عليك سوى إضافة التكوين pom.xml التالي. بعد ذلك ، يمكنك تجربة أمثلة هذه المقالة بالإضافة إلى العديد من الأمثلة الأخرى المتوفرة على [GitHub] (https://github.com/groupdocs-metadata). للحصول على التفاصيل ، يمكنك زيارة [مرجع واجهة برمجة التطبيقات] (https://apireference.groupdocs.com/metadata/java).

<repository>
	<id>GroupDocsJavaAPI</id>
	<name>GroupDocs Java API</name>
	<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-metadata</artifactId>
        <version>22.2</version> 
</dependency>

قراءة علامات MP3 ID3 في Java - ID3v1 و ID3v2

توضح الخطوات التالية كيفية قراءة علامات MP3 ID3v1 باستخدام Java.

يقرأ كود مصدر Java التالي بعض علامات MP3 ID3v1 لملف MP3.

// قراءة علامات ملف MP3 ID3V1
try (Metadata metadata = new Metadata("path/audio-ID3V1.mp3")) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	if (root.getID3V1() != null) {

		System.out.println(root.getID3V1().getAlbum());
		System.out.println(root.getID3V1().getArtist());
		System.out.println(root.getID3V1().getTitle());
		System.out.println(root.getID3V1().getVersion());
		System.out.println(root.getID3V1().getComment());
		// ...
	}
}

يمكنك استخراج علامات ID3v2 بطريقة مماثلة. توضح الخطوات التالية كيفية استرداد علامات MP3 ID3v2 في Java.

يقرأ مثال كود مصدر Java التالي بعض علامات MP3 ID3v2 وتفاصيل الصور المرفقة لملف MP3.

// قراءة علامات ملف MP3 ID3V2
try (Metadata metadata = new Metadata("path/audio-ID3V2.mp3")) {
    MP3RootPackage root = metadata.getRootPackageGeneric();
 
    if (root.getID3V2() != null) {
        System.out.println(root.getID3V2().getAlbum());
        System.out.println(root.getID3V2().getArtist());
        System.out.println(root.getID3V2().getBand());
        System.out.println(root.getID3V2().getTitle());
        System.out.println(root.getID3V2().getComposers());
        System.out.println(root.getID3V2().getCopyright());
        System.out.println(root.getID3V2().getPublisher());
        System.out.println(root.getID3V2().getOriginalAlbum());
        System.out.println(root.getID3V2().getMusicalKey());
 
        if (root.getID3V2().getAttachedPictures() != null) {
            for (ID3V2AttachedPictureFrame attachedPicture : root.getID3V2().getAttachedPictures()) {
                System.out.println(attachedPicture.getAttachedPictureType());
                System.out.println(attachedPicture.getMimeType());
                System.out.println(attachedPicture.getDescription()); 
            }
        }
    }
}

قراءة علامات كلمات MP3 في جافا

توجه الخطوات التالية كيفية قراءة علامات MP3 Lyrics في Java.

يسترد مقتطف كود Java التالي علامات كلمات MP3 وبعض الخصائص من ملف MP3.

// قراءة علامات كلمات ملف MP3
try (Metadata metadata = new Metadata("path/audio-Lyrics.mp3")) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	if (root.getLyrics3V2() != null) {
		System.out.println(root.getLyrics3V2().getLyrics());
		System.out.println(root.getLyrics3V2().getAlbum());
		System.out.println(root.getLyrics3V2().getArtist());
		System.out.println(root.getLyrics3V2().getTrack());
		// ...

    // وبالمثل ، يمكنك اجتياز حقول العلامات
		for (LyricsField field : root.getLyrics3V2().toList()) {
			System.out.println(String.format("%s = %s", field.getID(), field.getData()));
		}
	}
}

قراءة علامات MP3 APEv2 في جافا

توضح الخطوات التالية كيف يمكننا استخراج علامات MP3 APEv2 داخل تطبيق Java.

تقرأ أمثلة كود Java التالية بعض خصائص علامات MP3 APE لملف MP3.

// قراءة علامات ملف MP3 APE
try (Metadata metadata = new Metadata("path/audio-APE.mp3")) {
	MP3RootPackage root = metadata.getRootPackageGeneric();

	if (root.getApeV2() != null) {
		System.out.println(root.getApeV2().getAlbum());
		System.out.println(root.getApeV2().getTitle());
		System.out.println(root.getApeV2().getArtist());
		System.out.println(root.getApeV2().getComposer());
		System.out.println(root.getApeV2().getCopyright());
		System.out.println(root.getApeV2().getGenre());
		System.out.println(root.getApeV2().getLanguage());
		// ...
	}

احصل على ترخيص API مجاني

يمكنك [الحصول على ترخيص مؤقت مجاني] (https://purchase.groupdocs.com/tporary-license) لاستخدام واجهة برمجة التطبيقات دون قيود التقييم.

استنتاج

باختصار ، تعلمنا كيفية استخراج علامات البيانات الوصفية من ملفات MP3 في Java. واحدًا تلو الآخر ، نقرأ علامات ID3v1 و ID3v2 و Lyrics و APE وخصائصها من ملفات MP3. فكر في إنشاء محرر علامات MP3 وعارض البيانات الوصفية الخاص بك تمامًا مثل [تطبيق البيانات الوصفية عبر الإنترنت] (https://products.groupdocs.app/metadata/total).

تعرف على المزيد حول واجهة برمجة التطبيقات من [الوثائق] (https://docs.groupdocs.com/metadata/java/) واتصل بنا للحصول على استفسارات عبر [المنتدى] (https://forum.groupdocs.com/).

أنظر أيضا