Android音乐播放器RecyclerView无法显示音乐数据求助

一、权限检查 #

• 确认AndroidManifest.xml已声明必要权限：

  <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
  <!-- Android 12及以下版本额外声明 -->
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  

• 检查代码中是否完成动态权限申请（Android 6.0+强制要求）：

  if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_AUDIO) != PackageManager.PERMISSION_GRANTED) {
      registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
          if (granted) {
              // 权限通过后重新执行媒体查询
              loadAllSongs()
          }
      }.launch(Manifest.permission.READ_MEDIA_AUDIO)
  }
  

二、媒体查询逻辑验证 #

• 检查查询投影字段与筛选条件是否正确：

  val projection = arrayOf(
      MediaStore.Audio.Media.TITLE,
      MediaStore.Audio.Media.ARTIST,
      MediaStore.Audio.Media.DATA,
      MediaStore.Audio.Media._ID
  )
  // 仅检索标记为音乐的文件
  val selection = "${MediaStore.Audio.Media.IS_MUSIC} = 1"
  val cursor = contentResolver.query(
      MediaStore.Audio.Media.EXTERNAL_CONTENT_URI,
      projection,
      selection,
      null,
      "${MediaStore.Audio.Media.TITLE} ASC"
  )
  

• 验证Cursor有效性与数据量：

  cursor?.run {
      if (count == 0) {
          Log.d("MusicDebug", "未检索到音乐文件")
          close()
          return
      }
      // 遍历Cursor填充SongModel列表
      val songList = mutableListOf<SongModel>()
      while (moveToNext()) {
          val title = getString(getColumnIndexOrThrow(MediaStore.Audio.Media.TITLE))
          val artist = getString(getColumnIndexOrThrow(MediaStore.Audio.Media.ARTIST))
          songList.add(SongModel(title, artist))
      }
      close()
      // 更新Adapter数据
      adapter.updateData(songList)
  } ?: Log.e("MusicDebug", "媒体查询Cursor为空")
  

三、RecyclerView配置检查 #

• 确认已设置LayoutManager与Adapter：

  val recyclerView = findViewById<RecyclerView>(R.id.recycler_view)
  recyclerView.layoutManager = LinearLayoutManager(this)
  val adapter = AllSongsAdapter(mutableListOf())
  recyclerView.adapter = adapter
  

• 数据更新时必须调用Adapter通知方法：

  // 在Adapter中添加数据更新方法
  fun updateData(newList: List<SongModel>) {
      songList.clear()
      songList.addAll(newList)
      notifyDataSetChanged()
      // 推荐使用DiffUtil提升性能
  }
  

四、Adapter与布局绑定验证 #

• 检查onCreateViewHolder是否正确加载Item布局：

  override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
      val view = LayoutInflater.from(parent.context).inflate(R.layout.item_song, parent, false)
      return ViewHolder(view)
  }
  

• 验证onBindViewHolder中视图与数据的绑定是否匹配：

  override fun onBindViewHolder(holder: ViewHolder, position: Int) {
      val song = songList[position]
      holder.tvTitle.text = song.title
      holder.tvArtist.text = song.artist
      // 确保布局中控件ID与代码引用一致
  }
  

• 检查Item布局（如item_song.xml）是否设置了合理的高度，避免因wrap_content或固定高度为0导致视图不可见。

五、调试技巧 #

• 在媒体查询完成后打印日志，确认数据是否正确获取：

  Log.d("MusicDebug", "成功加载${songList.size}首音乐")
  

• 媒体查询操作建议放在子线程执行，避免阻塞主线程：

  lifecycleScope.launch(Dispatchers.IO) {
      val songList = queryAllSongs()
      withContext(Dispatchers.Main) {
          adapter.updateData(songList)
      }
  }
  

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