MediaStore 更新非自有音频元数据返回 0 的排查
结论
contentResolver.update() 返回 0,通常不是权限异常,而是这次 update 没有匹配到可写行,或者要写的列被 MediaProvider 过滤掉了。对于非本应用拥有的媒体项,Android 11(API 30)及以上应使用 MediaStore.createWriteRequest() 获取用户授权,然后用精确的 item Uri 和 null selection 更新。用集合 Uri 加 _ID selection 更新非自有项,很容易不生效。
排查步骤
-
只更新一个最小可写列做验证
先不要同时写GENRE和TITLE。用MediaStore.Audio.Media.TITLE或MediaStore.MediaColumns.IS_FAVORITE单独测试,确认返回 1。若单列返回 1,再把其他列逐个加回,定位是哪一列导致返回 0。 -
使用精确 Uri,selection 传
null
不要用EXTERNAL_CONTENT_URI加_ID = ?去更新非自有项;createWriteRequest()授权的是具体 item Uri。更新时直接用content://media/external/audio/media/339这类 Uri,并传null, null。 -
确认授权结果与 API 版本
MediaStore.createWriteRequest()是 API 30 引入的。Android 10 及以下需要按目标版本处理存储兼容逻辑。MediaStore.canManageMedia(this)不是写请求的授权判断,不要用它判断本次授权是否成功。 -
检查 volume 是否一致
如果文件实际不在external主卷上,却用MediaStore.Audio.Media.EXTERNAL_CONTENT_URI或externalUri 更新,可能匹配不到。优先使用从查询结果拿到的原始 Uri。
示例代码
请求写权限:
private fun requestWrite(uris: List<Uri>) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
val pi = MediaStore.createWriteRequest(contentResolver, uris)
ActivityCompat.startIntentSenderForResult(
this,
pi.intentSender,
REQ_WRITE,
null,
0,
0,
0,
null
)
} else {
// Android 10 及以下按存储兼容策略处理
}
}
授权成功后更新单个 Uri:
private fun updateTitle(uri: Uri): Int {
val values = ContentValues().apply {
put(MediaStore.Audio.Media.TITLE, "NewTitle")
// 先不要同时写 GENRE,便于定位
}
return contentResolver.update(uri, values, null, null)
}
if (requestCode == REQ_WRITE && resultCode == Activity.RESULT_OK) {
uris.forEach { uri ->
val rows = updateTitle(uri)
Log.d("MediaUpdate", "uri=$uri rows=$rows")
}
}
如果 rows == 1,说明权限链路正常,这一列也允许写;如果仍是 0,重点检查列是否可写、Uri 是否属于同一个 volume,以及目标文件是否真的可修改。GENRE 这类字段建议单独测试,必要时改用能直接写音频标签的库,并确认系统 MediaProvider 的行为。
备注:内容仅供参考。
