如何使用content://格式URI设置Just Audio后台通知本地音频封面图？

针对你使用just_audio_background时，本地content://格式artUri无法在通知面板正常显示封面的问题，可按以下步骤排查解决：

• 确认URI的可访问权限
  Android通知服务运行在独立系统进程，必须能正常访问你提供的content:// URI：

  • 若URI来自系统MediaStore的媒体文件，确保已申请对应权限：Android 12及以下需READ_EXTERNAL_STORAGE，Android 13+需READ_MEDIA_IMAGES；如果是通过文件选择器获取的URI，需调用ContentResolver.takePersistableUriPermission保留持久访问权限。
  • 若URI来自自定义ContentProvider，需在AndroidManifest的Provider配置中设置android:exported="true"，并添加合适的权限声明，保证系统通知进程能访问该Provider。

• 验证URI的有效性
  先通过代码测试能否读取URI对应的图片，确认URI本身无问题：

  final resolver = await getContentResolver();
  final inputStream = await resolver.openInputStream(Uri.parse('你的content:// URI'));
  final bitmap = await BitmapFactory.decodeStream(inputStream);
  if (bitmap == null) {
    print('该URI对应的图片无法读取');
  }
  

  若读取失败，优先解决URI的有效性或权限问题，再设置artUri。

• 改用FileProvider生成合规Content URI
  如果图片是应用私有文件（比如存放在应用专属目录），不要自定义content://data/...格式的URI，改用Android官方的FileProvider生成标准Content URI：

  1. 在AndroidManifest中注册FileProvider：

     <provider
         android:name="androidx.core.content.FileProvider"
         android:authorities="你的应用包名.fileprovider"
         android:exported="false"
         android:grantUriPermissions="true">
         <meta-data
             android:name="android.support.FILE_PROVIDER_PATHS"
             android:resource="@xml/file_paths" />
     </provider>
     

  2. 在res/xml目录下创建file_paths.xml，配置允许访问的文件路径：

     <paths>
         <files-path name="covers" path="audio_covers/" />
     </paths>
     

  3. 生成URI并设置到MediaItem：

     final coverFile = File('你的本地图片绝对路径');
     final artUri = FileProvider.getUriForFile(
         context,
         '你的应用包名.fileprovider',
         coverFile,
     );
     // 将artUri赋值给MediaItem的对应字段
     

• 检查依赖版本
  确保使用的just_audio_background是最新版本，旧版本可能存在本地Content URI处理的兼容性问题，更新后重试。

内容的提问来源于stack exchange，提问作者Michael Stephen