Exif (Exchangeable Image File Format) 將拍攝參數嵌入 JPEG 檔案頭:光圈、快門、ISO、白平衡、焦距、日期時間、相機型號、GPS 座標、方向標籤等。Android 2.0+ (API 5) 引入 android.media.ExifInterface 支援讀寫。
| 方法 | 說明 |
|---|---|
ExifInterface(String filePath) | 建構子,傳入絕對路徑 (需檔案存在) |
getAttribute(String tag) | 取得字串屬性 (無則回傳 null) |
getAttributeInt(String tag, int defaultValue) | 取得整數屬性 |
getAttributeDouble(String tag, double defaultValue) | 取得浮點屬性 |
setAttribute(String tag, String value) | 設定屬性 (記憶體中修改) |
saveAttributes() | **將修改寫回檔案** (IO 密集,建議背景執行緒) |
| 常數 | 含義 | 型別 | 範例值 |
|---|---|---|---|
TAG_DATETIME | 拍攝日期時間 | String | "2023:10:15 14:30:00" |
TAG_MAKE | 相機廠商 | String | "Xiaomi" |
TAG_MODEL | 相機型號 | String | "Mi 10" |
TAG_ORIENTATION | 方向 (1-8) | int | 1=正常, 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_ISO | ISO 感光度 | String | "100" |
TAG_WHITE_BALANCE | 白平衡模式 | String | "Auto" |
TAG_GPS_LATITUDE | GPS 緯度 (度分秒) | String | "25/1, 3/1, 0/1" |
TAG_GPS_LONGITUDE | GPS 經度 | String | "121/1, 30/1, 0/1" |
TAG_GPS_ALTITUDE | 海拔高度 (米) | String | "100/1" |
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)
}
}
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")
ExifInterface 擴充支援部分格式,但建議仍以 JPEG 為主)。TAG_ORIENTATION 只接受整數字串 "1"~"8",寫入字串會被截斷/忽略。READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE (Android 10+ 使用 MediaStore 或應用專屬目錄免權限)。TAG_ORIENTATION 旋轉顯示,ImageView 直接 setImageBitmap 則需手動處理。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))
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