萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android ExifInterface 完整指南:讀寫 JPEG 照片元數據 (拍攝參數、GPS、方向)

什麼是 Exif?

Exif (Exchangeable Image File Format) 將拍攝參數嵌入 JPEG 檔案頭:光圈、快門、ISO、白平衡、焦距、日期時間、相機型號、GPS 座標、方向標籤等。Android 2.0+ (API 5) 引入 android.media.ExifInterface 支援讀寫。

ExifInterface 核心 API

方法說明
ExifInterface(String filePath)建構子,傳入絕對路徑 (需檔案存在)
getAttribute(String tag)取得字串屬性 (無則回傳 null)
getAttributeInt(String tag, int defaultValue)取得整數屬性
getAttributeDouble(String tag, double defaultValue)取得浮點屬性
setAttribute(String tag, String value)設定屬性 (記憶體中修改)
saveAttributes()**將修改寫回檔案** (IO 密集,建議背景執行緒)

常用標籤常數 (ExifInterface.TAG_*)

常數含義型別範例值
TAG_DATETIME拍攝日期時間String"2023:10:15 14:30:00"
TAG_MAKE相機廠商String"Xiaomi"
TAG_MODEL相機型號String"Mi 10"
TAG_ORIENTATION方向 (1-8)int1=正常, 6=順時針90°, 8=逆時針90°
TAG_APERTURE光圈值 (F-number)String"f/2.0"
TAG_EXPOSURE_TIME曝光時間 (秒)String"1/100"
TAG_FOCAL_LENGTH焦距 (mm)String"4.5"
TAG_ISOISO 感光度String"100"
TAG_WHITE_BALANCE白平衡模式String"Auto"
TAG_GPS_LATITUDEGPS 緯度 (度分秒)String"25/1, 3/1, 0/1"
TAG_GPS_LONGITUDEGPS 經度String"121/1, 30/1, 0/1"
TAG_GPS_ALTITUDE海拔高度 (米)String"100/1"

讀取 Exif 範例

fun readExifInfo(filePath: String) {
    try {
        val exif = ExifInterface(filePath)
        val tags = mapOf(
            "拍攝時間" to exif.getAttribute(ExifInterface.TAG_DATETIME),
            "廠商" to exif.getAttribute(ExifInterface.TAG_MAKE),
            "型號" to exif.getAttribute(ExifInterface.TAG_MODEL),
            "方向" to exif.getAttributeInt(ExifInterface.TAG_ORIENTATION, 1),
            "光圈" to exif.getAttribute(ExifInterface.TAG_APERTURE),
            "快門" to exif.getAttribute(ExifInterface.TAG_EXPOSURE_TIME),
            "焦距" to exif.getAttribute(ExifInterface.TAG_FOCAL_LENGTH),
            "ISO" to exif.getAttribute(ExifInterface.TAG_ISO),
            "白平衡" to exif.getAttribute(ExifInterface.TAG_WHITE_BALANCE),
            "緯度" to exif.getAttribute(ExifInterface.TAG_GPS_LATITUDE),
            "經度" to exif.getAttribute(ExifInterface.TAG_GPS_LONGITUDE)
        )
        tags.forEach { (k, v) -> if (v != null) Log.i("Exif", "$k: $v") }
    } catch (e: IOException) {
        Log.e("Exif", "讀取失敗", e)
    }
}

修改 Exif 範例 (如修正方向、添加水印資訊)

fun updateExif(filePath: String, tag: String, value: String) {
    Executors.newSingleThreadExecutor().execute {
        try {
            val exif = ExifInterface(filePath)
            exif.setAttribute(tag, value)
            exif.saveAttributes() // 必須調用才會寫入磁碟
            Log.i("Exif", "更新成功: $tag=$value")
        } catch (e: IOException) {
            Log.e("Exif", "寫入失敗", e)
        }
    }
}

// 用法:修正旋轉標籤為正常 (1)
updateExif("/sdcard/photo.jpg", ExifInterface.TAG_ORIENTATION, "1")

關鍵注意事項

  1. saveAttributes() 效能低:會重寫整個檔案頭,大檔案耗時明顯,**必須在背景執行緒**執行。
  2. 僅支援 JPEG:PNG、WebP、HEIF 不支援 (Android 10+ ExifInterface 擴充支援部分格式,但建議仍以 JPEG 為主)。
  3. 標籤型別固定:TAG_ORIENTATION 只接受整數字串 "1"~"8",寫入字串會被截斷/忽略。
  4. 權限:讀寫外部儲存需 READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE (Android 10+ 使用 MediaStore 或應用專屬目錄免權限)。
  5. 方向標籤自動旋轉:Glide/Coil/Picasso 等圖片庫會自動讀取 TAG_ORIENTATION 旋轉顯示,ImageView 直接 setImageBitmap 則需手動處理。

進階:GPS 度分秒轉十進制度

fun dmsToDecimal(dms: String?, ref: String?): Double? {
    if (dms == null) return null
    // 格式: "25/1, 3/1, 0/1" -> 度/分/秒 (分母通常為1)
    val parts = dms.split(",").map { it.trim() }
    if (parts.size != 3) return null
    fun parseFraction(s: String) = s.split("/").let { it[0].toDouble() / it[1].toDouble() }
    val degrees = parseFraction(parts[0])
    val minutes = parseFraction(parts[1])
    val seconds = parseFraction(parts[2])
    var decimal = degrees + minutes/60 + seconds/3600
    if (ref != null && ref.uppercase() in setOf("S", "W")) decimal = -decimal
    return decimal
}

// 使用
val lat = dmsToDecimal(exif.getAttribute(TAG_GPS_LATITUDE), exif.getAttribute(TAG_GPS_LATITUDE_REF))
val lon = dmsToDecimal(exif.getAttribute(TAG_GPS_LONGITUDE), exif.getAttribute(TAG_GPS_LONGITUDE_REF))

現代替代:ExifInterface (AndroidX 版)

androidx.exifinterface:exifinterface:1.3.6+ 回溯支援 API 21+,新增對 PNG/WebP/HEIC 的讀取支援、更穩健的錯誤處理、Kotlin 擴充函數。建議新專案直接依賴 AndroidX 版本。

implementation "androidx.exifinterface:exifinterface:1.3.6"

// 用法幾乎相同
val exif = ExifInterface(FileInputStream(file).fd) // 支援 FileDescriptor
val lat = exif.getLatLong() // 直接回傳 double[2] {lat, lon} 或 null
copyright © 萬盛學電腦網 all rights reserved