PAYATHON 2026

MediaStore 更新非自有音频元数据返回 0 的排查

数据小陈

结论

contentResolver.update() 返回 0,通常不是权限异常,而是这次 update 没有匹配到可写行,或者要写的列被 MediaProvider 过滤掉了。对于非本应用拥有的媒体项,Android 11(API 30)及以上应使用 MediaStore.createWriteRequest() 获取用户授权,然后用精确的 item Uri 和 null selection 更新。用集合 Uri 加 _ID selection 更新非自有项,很容易不生效。

排查步骤

  1. 只更新一个最小可写列做验证
    先不要同时写 GENRE 和 TITLE。用 MediaStore.Audio.Media.TITLE 或 MediaStore.MediaColumns.IS_FAVORITE 单独测试,确认返回 1。若单列返回 1,再把其他列逐个加回,定位是哪一列导致返回 0。

  2. 使用精确 Uri,selection 传 null
    不要用 EXTERNAL_CONTENT_URI 加 _ID = ? 去更新非自有项;createWriteRequest() 授权的是具体 item Uri。更新时直接用 content://media/external/audio/media/339 这类 Uri,并传 null, null。

  3. 确认授权结果与 API 版本
    MediaStore.createWriteRequest() 是 API 30 引入的。Android 10 及以下需要按目标版本处理存储兼容逻辑。MediaStore.canManageMedia(this) 不是写请求的授权判断,不要用它判断本次授权是否成功。

  4. 检查 volume 是否一致
    如果文件实际不在 external 主卷上,却用 MediaStore.Audio.Media.EXTERNAL_CONTENT_URI 或 external Uri 更新,可能匹配不到。优先使用从查询结果拿到的原始 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 的行为。

备注:内容仅供参考。