Mp3文件標簽信息讀取和寫入(Kotlin)

原文:Mp3文件標簽信息讀取和寫入(Kotlin) - Stars-One的雜貨小窩

最近準備抽空完善了自己的星之小說下載器（JavaFx應用 ）,發現下載下來的mp3文件沒有對應的標簽

也是瞭解可以通過mpatric這個庫來實現標簽的讀取和寫入,下麵介紹一下關於mp3標簽和貼上對應的代碼示例

標簽介紹

在研究過程,發現mp3音樂標簽主要有以下幾種格式:

• ID3v1
• ID3v2(目前常用)
• APEv2

ID3v1位於文件尾部，不支持封面，不支持一些特殊字元，長度短，但相容老設備。

ID3v2是ID3v1的後繼替代者，位於文件頭部，支持封面和特殊字元，長度任意。推薦使用。

APEv2位於文件尾部（同時與ID3v1存在時，在ID3v1之前），同樣支持封面和特殊字元，但不推薦用於mp3。

常用的主要是ID3v2.而ID3v2格式又可具體分為3種:

• ID3v2.4 UTF-8
• ID3v2.3 UTF-16
• ID3v2.3 ISO-8859-1

推薦用ID3v2.4 UTF-8，如果設備不支持可退一步用ID3v2.3 UTF-16，如果設備仍不支持可再退一步用ID3v2.3 ISO-8859-1。

如果數位設備不支持，那麼再試APEv2或ID3v1。根據設備支持情況進行調整就可以。

使用

引入依賴:

<dependency>
  <groupId>com.mpatric</groupId>
  <artifactId>mp3agic</artifactId>
  <version>0.9.1</version>
</dependency>

@Test
fun testRead() {

    val mp3Path = "D:\\temp\\music-download-test\\封印されし神々（東方風神録） - Whirling Truth.mp3"
    val mp3File = Mp3File(mp3Path)

    if (mp3File.hasId3v2Tag()) {
        val id3v2Tag = mp3File.id3v2Tag
        println("唱片歌曲數量: " + id3v2Tag.track)
        println("藝術家: " + id3v2Tag.artist)
        println("歌曲名: " + id3v2Tag.title)
        println("唱片名: " + id3v2Tag.album)
        println("歌曲長度:" + mp3File.lengthInSeconds + "秒")
        println("碼率: " + mp3File.bitrate + " kbps " + if (mp3File.isVbr) "(VBR)" else "(CBR)")


        println("專輯插畫類型" + id3v2Tag.albumImageMimeType)
        println("發行時間: " + id3v2Tag.year)
        println("流派: " + id3v2Tag.genre + " (" + id3v2Tag.genreDescription + ")")
        println("註釋: " + id3v2Tag.comment)
        println("歌詞: " + id3v2Tag.lyrics)
        println("作曲家: " + id3v2Tag.composer)
        println("發行公司: " + id3v2Tag.publisher)
        println("Original artist: " + id3v2Tag.originalArtist)
        println("Album artist: " + id3v2Tag.albumArtist)
        println("版權: " + id3v2Tag.copyright)
        println("URL: " + id3v2Tag.url)
        println("編碼格式: " + id3v2Tag.encoder)

        //專輯插畫
        val albumImageData = id3v2Tag.albumImage
        if (albumImageData != null) {
            println("專輯插圖長度: " + albumImageData.size + " bytes")
            println("專輯插圖類型: " + id3v2Tag.albumImageMimeType)
        }
        val imgFile = File("D:\\temp\\output.jpg")
        imgFile.writeBytes(albumImageData)
    }
}

@Test
fun testWrite() {
    //todo m4a轉MP3
    //val mp3Path = "D:\\temp\\music-download-test\\Romantic Night.mp3"
    val mp3Path = "D:\\temp\\music-download-test\\test.mp3"
    val imgFile = File("D:\\temp\\music-download-test\\109951167834013257.jpg")
    val mp3File = Mp3File(mp3Path)
    val tag = mp3File.id3v2Tag
    //歌曲名
    tag.title = mp3File.filename
    //歌手
    tag.artist = "張三"
    //唱片名(專輯)
    tag.album = "張三的專輯"

    tag.setAlbumImage(imgFile.readBytes(), MimetypesFileTypeMap.getDefaultFileTypeMap().getContentType(imgFile))

    mp3File.save("D:\\temp\\music-download-test\\output.mp3")
}

之後測試,在window系統右鍵屬性就可以看到顯示了對應的屬性

API大全

Mp3File對象方法

ID3v1對象方法

ID3v2對象方法（ID3v2為ID3v1的子類）

參考

• mpatric/mp3agic: A java library for reading mp3 files and reading / manipulating the ID3 tags (ID3v1 and ID3v2.2 through ID3v2.4).
• mp3處理工具（mp3agic）_鄭重其事,鵬程萬里的博客-CSDN博客
• 請問mp3音樂標簽中，ID3v1,ID3v2,APEv2這三種類型的標簽能否任意添加或者刪除？ - 知乎
• Java為MP3文件嵌入封面圖片_來自大山深處的Doge_的博客-CSDN博客