cw

app/src/androidTest/java/com/example/musicplayer/ExampleInstrumentedTest.java

@@ -7,20 +7,28 @@ import android.support.test.runner.AndroidJUnit4;
 import org.junit.Test;
 import org.junit.runner.RunWith;
 
-import static org.junit.Assert.*;
-
 /**
- * Instrumented test, which will execute on an Android device.
+ * ExampleInstrumentedTest 是一个继承自 AndroidJUnit4 的测试类，用于在Android设备上执行测试。
- *
+ * <p>
+ * 这个类包含了一个测试方法 useAppContext，用于验证应用程序的上下文是否正确。
+ * <p>
  * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ * 注意：上面的链接是指向Android官方文档中关于测试的文档，如果无法访问，可能是因为网络问题或者链接不正确。
  */
 @RunWith(AndroidJUnit4.class)
 public class ExampleInstrumentedTest {
+    /**
+     * useAppContext 是一个测试方法，用于验证应用程序的上下文。
+     * 这个方法会检查测试的应用程序的包名是否与预期的包名相匹配。
+     * @throws Exception 如果测试失败，则抛出异常。
+     */
     @Test
     public void useAppContext() throws Exception {
-        // Context of the app under test.
+        // 获取当前测试的应用程序的上下文环境
         Context appContext = InstrumentationRegistry.getTargetContext();
 
+        // 断言测试的应用程序的包名是否为 "com.example.musicplayer"
+        // 如果包名不匹配，则测试失败，并抛出异常
         assertEquals("com.example.musicplayer", appContext.getPackageName());
     }
 }

app/src/main/assets/litepal.xml

@@ -1,18 +1,31 @@
 <?xml version="1.0" encoding="utf-8"?>
+<!-- LitePal 配置文件 -->
 <litepal>
+    <!-- 数据库名称 -->
     <dbname value="SongList" />
     
+    <!-- 数据库版本 -->
     <version value="27" />
     
+    <!-- 实体类映射列表 -->
     <list>
+        <!-- 在线歌曲实体类 -->
         <mapping class="com.example.musicplayer.entiy.OnlineSong" />
+        <!-- 本地歌曲实体类 -->
         <mapping class="com.example.musicplayer.entiy.LocalSong" />
+        <!-- 搜索历史实体类 -->
         <mapping class="com.example.musicplayer.entiy.SearchHistory" />
+        <!-- 喜欢的歌曲实体类 -->
         <mapping class="com.example.musicplayer.entiy.Love" />
+        <!-- 历史歌曲实体类 -->
         <mapping class="com.example.musicplayer.entiy.HistorySong" />
+        <!-- 专辑收藏实体类 -->
         <mapping class="com.example.musicplayer.entiy.AlbumCollection" />
+        <!-- 下载歌曲实体类 -->
         <mapping class="com.example.musicplayer.entiy.DownloadSong" />
+        <!-- 下载信息实体类 -->
         <mapping class="com.example.musicplayer.entiy.DownloadInfo"/>
+        <!-- 歌曲实体类 -->
         <mapping class="com.example.musicplayer.entiy.Song"/>
     </list>
 </litepal>

app/src/main/java/com/example/musicplayer/adapter/AlbumSongAdapter.java

@@ -17,34 +17,53 @@ import com.example.musicplayer.util.FileUtil;
 import java.util.List;
 
 /**
- * Created by 残渊 on 2018/11/27.
+ * AlbumSongAdapter 是一个 RecyclerView.Adapter 的扩展，用于展示专辑中的歌曲列表。
  */
-
 public class AlbumSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
 
+    // 歌曲数据列表
     private List<AlbumSong.DataBean.ListBean> mSongsBeanList;
+    // 上一个被点击的位置
     private int mLastPosition = -1;
+    // 点击事件的监听器
     private OnItemClickListener mSongClick;
+    // 歌曲项的视图类型
     private final int songType = 1;
+    // 底部视图的类型
     private final int footerType = 2;
 
+    /**
+     * 构造函数，初始化歌曲列表。
+     * @param songsBeans 歌曲数据的列表
+     */
     public AlbumSongAdapter(List<AlbumSong.DataBean.ListBean> songsBeans) {
         mSongsBeanList = songsBeans;
     }
 
+    /**
+     * 设置歌曲点击事件的监听器。
+     * @param songClick 点击事件监听器
+     */
     public void setSongClick(OnItemClickListener songClick) {
         mSongClick = songClick;
     }
 
+    /**
+     * 创建新的ViewHolder实例。
+     * @param parent 父布局
+     * @param viewType 视图类型
+     * @return 返回对应的ViewHolder
+     */
     @NonNull
     @Override
     public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        // 根据视图类型创建不同的ViewHolder
         if (viewType == songType) {
             View view = LayoutInflater.from(parent.getContext())
                     .inflate(R.layout.recycler_song_search_item, parent, false);
             ViewHolder viewHolder = new ViewHolder(view);
             return viewHolder;
-        }else{
+        } else {
             View view = LayoutInflater.from(parent.getContext())
                     .inflate(R.layout.footer_view_player_height, parent, false);
             FooterHolder footerHolder = new FooterHolder(view);
@@ -52,12 +71,18 @@ public class AlbumSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHold
         }
     }
 
+    /**
+     * 将数据绑定到ViewHolder上。
+     * @param viewHolder 当前ViewHolder
+     * @param position 当前位置
+     */
     @Override
     public void onBindViewHolder(@NonNull RecyclerView.ViewHolder viewHolder, final int position) {
+        // 如果是歌曲类型的ViewHolder
         if (viewHolder instanceof ViewHolder) {
             ViewHolder holder = (ViewHolder) viewHolder;
             AlbumSong.DataBean.ListBean songsBean = mSongsBeanList.get(position);
-            //设置歌手，因为歌手可能有两个
+            // 设置歌手名称，可能包含多个歌手
             StringBuilder singer = new StringBuilder(songsBean.getSinger().get(0).getName());
             for (int i = 1; i < songsBean.getSinger().size(); i++) {
                 singer.append("、").append(songsBean.getSinger().get(i).getName());
@@ -65,8 +90,8 @@ public class AlbumSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHold
             holder.artistTv.setText(singer.toString());
             holder.titleTv.setText(songsBean.getSongname());
             holder.mItemView.setBackgroundResource(R.color.translucent);
-            //根据点击显示
+            // 根据当前播放的歌曲设置不同的显示效果
-                if(songsBean.getSongmid().equals(FileUtil.getSong().getSongId())){
+            if(songsBean.getSongmid().equals(FileUtil.getSong().getSongId())){
                 holder.playLine.setVisibility(View.VISIBLE);
                 holder.titleTv.setTextColor(App.getContext().getResources().getColor(R.color.yellow));
                 holder.artistTv.setTextColor(App.getContext().getResources().getColor(R.color.yellow));
@@ -76,6 +101,7 @@ public class AlbumSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHold
                 holder.titleTv.setTextColor(App.getContext().getResources().getColor(R.color.white));
                 holder.artistTv.setTextColor(App.getContext().getResources().getColor(R.color.white_blue));
             }
+            // 设置点击事件
             holder.mItemView.setOnRippleCompleteListener(rippleView -> {
                 mSongClick.onClick(position);
                 equalPosition(position);
@@ -83,18 +109,29 @@ public class AlbumSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHold
         }
     }
 
-
+    /**
+     * 返回总的条目数，包括底部视图。
+     * @return 总条目数
+     */
     @Override
     public int getItemCount() {
         return mSongsBeanList.size() + 1;
     }
+
+    /**
+     * 根据位置返回不同的视图类型。
+     * @param position 位置
+     * @return 视图类型
+     */
     @Override
     public int getItemViewType(int position) {
         return position + 1 == getItemCount() ? footerType : songType;
     }
 
+    /**
+     * ViewHolder类，用于歌曲列表项。
+     */
     class ViewHolder extends RecyclerView.ViewHolder {
-
         TextView titleTv;
         TextView artistTv;
         RippleView mItemView;
@@ -109,13 +146,19 @@ public class AlbumSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHold
         }
     }
 
+    /**
+     * FooterHolder类，用于底部视图。
+     */
     class FooterHolder extends RecyclerView.ViewHolder {
         FooterHolder(View itemView) {
             super(itemView);
         }
     }
 
-    //判断点击的是否为上一个点击的项目
+    /**
+     * 处理点击事件，更新上一次点击的位置。
+     * @param position 当前点击的位置
+     */
     private void equalPosition(int position) {
         if (position != mLastPosition) {
             if (mLastPosition != -1) notifyItemChanged(mLastPosition);

app/src/main/java/com/example/musicplayer/adapter/DownloadSongAdapter.java

@@ -17,6 +17,7 @@ import com.example.musicplayer.util.FileUtil;
 import java.util.List;
 
 /**
+ * DownloadSongAdapter 是一个 RecyclerView.Adapter 的扩展，用于展示已下载歌曲的列表。
  * <pre>
  *     author : 残渊
  *     time   : 2019/09/18
@@ -25,30 +26,52 @@ import java.util.List;
  */
 
 public class DownloadSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
+    // 用于日志记录的标签
     private static final String TAG = "LoveSongAdapter";
+    // 底部视图类型
     private int footerViewType = 1;
+    // 歌曲项视图类型
     private int itemViewType = 0;
+    // 已下载歌曲的数据列表
     private List<DownloadSong> mDownloadSongList;
+    // 上下文环境
     private Context mContext;
+    // 上一个被点击的位置
     private int mLastPosition = -1;
+    // 点击事件的监听器
     private OnItemClickListener onItemClickListener;
 
+    /**
+     * 设置点击事件的监听器。
+     * @param onItemClickListener 点击事件监听器
+     */
     public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
         this.onItemClickListener = onItemClickListener;
     }
 
+    /**
+     * 构造函数，初始化上下文环境和已下载歌曲的数据列表。
+     * @param context 上下文环境
+     * @param loveList 已下载歌曲的数据列表
+     */
     public DownloadSongAdapter(Context context, List<DownloadSong> loveList) {
         mContext = context;
         mDownloadSongList = loveList;
     }
 
-
+    /**
+     * ViewHolder类，用于歌曲列表项。
+     */
     class ViewHolder extends RecyclerView.ViewHolder {
         TextView songNameTv;
         TextView singerTv;
         View playLine;
         RippleView item;
 
+        /**
+         * 构造函数，初始化歌曲列表项的视图。
+         * @param itemView 歌曲列表项的视图
+         */
         public ViewHolder(View itemView) {
             super(itemView);
             songNameTv = itemView.findViewById(R.id.tv_title);
@@ -59,21 +82,31 @@ public class DownloadSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewH
     }
 
     /**
-     * 底部holder
+     * FooterHolder类，用于底部视图。
      */
     static class FooterHolder extends RecyclerView.ViewHolder {
-
         TextView numTv;
 
+        /**
+         * 构造函数，初始化底部视图的视图。
+         * @param itemView 底部视图的视图
+         */
         public FooterHolder(View itemView) {
             super(itemView);
             numTv = itemView.findViewById(R.id.tv_song_num);
         }
     }
 
+    /**
+     * 创建新的ViewHolder实例。
+     * @param parent 父布局
+     * @param viewType 视图类型
+     * @return 返回对应的ViewHolder
+     */
     @NonNull
     @Override
     public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        // 根据视图类型创建不同的ViewHolder
         if (viewType == itemViewType) {
             View view = LayoutInflater.from(parent.getContext())
                     .inflate(R.layout.recycler_song_search_item, parent, false);
@@ -87,15 +120,21 @@ public class DownloadSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewH
         }
     }
 
+    /**
+     * 将数据绑定到ViewHolder上。
+     * @param viewHolder 当前ViewHolder
+     * @param position 当前位置
+     */
     @Override
     public void onBindViewHolder(@NonNull RecyclerView.ViewHolder viewHolder, int position) {
+        // 如果是歌曲类型的ViewHolder
         if (viewHolder instanceof ViewHolder) {
             ViewHolder holder = (ViewHolder) viewHolder;
             final DownloadSong downloadSong = mDownloadSongList.get(position);
 
             holder.songNameTv.setText(downloadSong.getName());
             holder.singerTv.setText(downloadSong.getSinger());
-            //根据点击显示
+            // 根据当前播放的歌曲设置不同的显示效果
             if (downloadSong.getSongId().equals(FileUtil.getSong().getSongId())) {
                 holder.playLine.setVisibility(View.VISIBLE);
                 mLastPosition = position;
@@ -117,12 +156,16 @@ public class DownloadSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewH
                 equalPosition(position);
             });
         } else {
+            // 如果是底部视图的ViewHolder
             FooterHolder footerHolder = (FooterHolder) viewHolder;
             footerHolder.numTv.setText("共" + mDownloadSongList.size() + "首音乐");
         }
     }
 
-    //判断点击的是否为上一个点击的项目
+    /**
+     * 处理点击事件，更新上一次点击的位置。
+     * @param position 当前点击的位置
+     */
     public void equalPosition(int position) {
         if (position != mLastPosition) {
             notifyItemChanged(mLastPosition);
@@ -131,11 +174,20 @@ public class DownloadSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewH
         notifyItemChanged(position);
     }
 
+    /**
+     * 返回总的条目数，包括底部视图。
+     * @return 总条目数
+     */
     @Override
     public int getItemCount() {
         return mDownloadSongList.size() + 1;
     }
 
+    /**
+     * 根据位置返回不同的视图类型。
+     * @param position 位置
+     * @return 视图类型
+     */
     @Override
     public int getItemViewType(int position) {
         return position + 1 == getItemCount() ? footerViewType : itemViewType;

app/src/main/java/com/example/musicplayer/adapter/DownloadingAdapter.java

@@ -20,6 +20,7 @@ import com.example.musicplayer.util.MediaUtil;
 import java.util.List;
 
 /**
+ * DownloadingAdapter 是一个 RecyclerView.Adapter 的扩展，用于展示正在下载的歌曲列表。
  * <pre>
  *     author : 残渊
  *     time   : 2019/09/17
@@ -28,25 +29,40 @@ import java.util.List;
  */
 
 public class DownloadingAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
-
+    // 正在下载的歌曲信息列表
-
     private List<DownloadInfo> downloadInfoList;
-
+    // 项点击事件监听器
     private OnItemClickListener onItemClickListener;
+    // 删除点击事件监听器
     private OnDeleteClickListener onDeleteClickListener;
 
+    /**
+     * 设置删除点击事件的监听器。
+     * @param onDeleteClickListener 删除事件监听器
+     */
     public void setOnDeleteClickListener(OnDeleteClickListener onDeleteClickListener){
         this.onDeleteClickListener = onDeleteClickListener;
     }
 
+    /**
+     * 设置项点击事件的监听器。
+     * @param onItemClickListener 项点击事件监听器
+     */
     public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
         this.onItemClickListener = onItemClickListener;
     }
 
+    /**
+     * 构造函数，初始化正在下载的歌曲信息列表。
+     * @param downloadInfoList 正在下载的歌曲信息列表
+     */
     public DownloadingAdapter(List<DownloadInfo> downloadInfoList) {
         this.downloadInfoList = downloadInfoList;
     }
 
+    /**
+     * ViewHolder类，用于下载列表项。
+     */
     class ViewHolder extends RecyclerView.ViewHolder {
         TextView songTv;
         TextView sizeTv;
@@ -54,6 +70,10 @@ public class DownloadingAdapter extends RecyclerView.Adapter<RecyclerView.ViewHo
         View itemView;
         ImageView cancelTv;
 
+        /**
+         * 构造函数，初始化下载列表项的视图。
+         * @param itemView 下载列表项的视图
+         */
         public ViewHolder(@NonNull View itemView) {
             super(itemView);
             this.itemView = itemView;
@@ -64,23 +84,34 @@ public class DownloadingAdapter extends RecyclerView.Adapter<RecyclerView.ViewHo
         }
     }
 
-
+    /**
+     * 创建新的ViewHolder实例。
+     * @param viewGroup 父布局
+     * @param viewType 视图类型
+     * @return 返回对应的ViewHolder
+     */
     @NonNull
     @Override
-    public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup viewGroup, int i) {
+    public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup viewGroup, int viewType) {
         View view = LayoutInflater.from(viewGroup.getContext())
                 .inflate(R.layout.recycler_downing_item, viewGroup, false);
         ViewHolder viewHolder = new ViewHolder(view);
         return viewHolder;
     }
 
+    /**
+     * 将数据绑定到ViewHolder上。
+     * @param viewHolder 当前ViewHolder
+     * @param position 当前位置
+     */
     @SuppressLint({"SetTextI18n", "ClickableViewAccessibility"})
     @Override
-    public void onBindViewHolder(@NonNull RecyclerView.ViewHolder viewHolder, int i) {
+    public void onBindViewHolder(@NonNull RecyclerView.ViewHolder viewHolder, int position) {
         ViewHolder holder = (ViewHolder) viewHolder;
         if (downloadInfoList.size() == 0) return;
-        DownloadInfo downloadInfo = downloadInfoList.get(i);
+        DownloadInfo downloadInfo = downloadInfoList.get(position);
         holder.songTv.setText(downloadInfo.getSongName());
+        // 根据下载状态设置不同的显示内容
         if(downloadInfo.getStatus() == Constant.DOWNLOAD_READY){//准备开始下载
             holder.sizeTv.setText("正在获取歌曲大小");
             holder.seekBar.setVisibility(View.GONE);
@@ -99,16 +130,18 @@ public class DownloadingAdapter extends RecyclerView.Adapter<RecyclerView.ViewHo
         }
         holder.seekBar.setOnTouchListener((view, motionEvent) -> true); //消费该事件，让seekBar不能拖动和点击
         holder.seekBar.setProgress(downloadInfo.getProgress());
-        //点击事件
+        // 设置点击事件
         holder.itemView.setOnClickListener(view -> {
-            onItemClickListener.onClick(i);
+            onItemClickListener.onClick(position);
         });
-        //取消
+        // 设置取消按钮点击事件
-        holder.cancelTv.setOnClickListener(view -> onDeleteClickListener.onClick(i));
+        holder.cancelTv.setOnClickListener(view -> onDeleteClickListener.onClick(position));
-
-
     }
 
+    /**
+     * 返回总的条目数。
+     * @return 总条目数
+     */
     @Override
     public int getItemCount() {
         return downloadInfoList.size();

app/src/main/java/com/example/musicplayer/adapter/ExpandableListViewAdapter.java

@@ -17,64 +17,80 @@ import com.example.musicplayer.util.CommonUtil;
 import java.util.List;
 
 /**
- * 自建歌单和收藏歌单的二级适配类
+ * 自建歌单和收藏歌单的二级适配类。
  * Created by 残渊 on 2018/9/23.
  */
 public class ExpandableListViewAdapter extends BaseExpandableListAdapter {
     private static final String TAG = "ExpandableListViewAdapter";
 
-    private String[] mGroupStrings;  //一级标题
+    private String[] mGroupStrings;  // 一级标题数组
-    private List<List<AlbumCollection>> mAlbumCollectionList; //二级收藏歌单列表
+    private List<List<AlbumCollection>> mAlbumCollectionList; // 二级歌单列表
-    private Context mContext;
+    private Context mContext; // 上下文环境
-    private OnChildItemClickListener mChildClickListener; //二级item的点击监听
+    private OnChildItemClickListener mChildClickListener; // 二级项的点击监听器
-
+
-
+    /**
+     * 构造函数，初始化适配器。
+     * @param context 上下文环境
+     * @param groupStrings 一级标题数组
+     * @param albumCollectionList 二级歌单列表
+     */
     public ExpandableListViewAdapter(Context context, String[] groupStrings, List<List<AlbumCollection>> albumCollectionList) {
         mAlbumCollectionList = albumCollectionList;
         mGroupStrings = groupStrings;
         mContext = context;
     }
-    //提供给外部使用
+
-    public  void setOnChildItemClickListener(OnChildItemClickListener onChildItemClickListener){
+    /**
-        mChildClickListener=onChildItemClickListener;
+     * 设置二级项的点击监听器。
+     * @param onChildItemClickListener 点击监听器
+     */
+    public void setOnChildItemClickListener(OnChildItemClickListener onChildItemClickListener){
+        mChildClickListener = onChildItemClickListener;
     }
 
+    // 获取一级列表的组数
     @Override
     public int getGroupCount() {
         return mGroupStrings.length;
     }
 
+    // 获取指定组的子项数
     @Override
     public int getChildrenCount(int groupPosition) {
         return mAlbumCollectionList.get(groupPosition).size();
     }
 
+    // 获取指定组的对象
     @Override
     public Object getGroup(int groupPosition) {
         return mGroupStrings[groupPosition];
     }
 
+    // 获取指定子项的对象
     @Override
     public Object getChild(int groupPosition, int childPosition) {
         return mAlbumCollectionList.get(groupPosition).get(childPosition);
     }
 
+    // 获取指定组的ID
     @Override
     public long getGroupId(int groupPosition) {
         return groupPosition;
     }
 
+    // 获取指定子项的ID
     @Override
     public long getChildId(int groupPosition, int childPosition) {
         return childPosition;
     }
 
+    // 是否有稳定的ID
     @Override
     public boolean hasStableIds() {
         return true;
     }
 
-    //绘制一级列表
+    // 绘制一级列表项
     @Override
     public View getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent) {
         View view;
@@ -90,7 +106,7 @@ public class ExpandableListViewAdapter extends BaseExpandableListAdapter {
             groupViewHolder = (GroupViewHolder) view.getTag();
         }
         groupViewHolder.groupTextView.setText(mGroupStrings[groupPosition]);
-        //根据展开的状态来改变箭头方向
+        // 根据展开状态改变箭头方向
         if (isExpanded) {
             groupViewHolder.pointIv.setImageResource(R.drawable.up);
         } else {
@@ -99,8 +115,7 @@ public class ExpandableListViewAdapter extends BaseExpandableListAdapter {
         return view;
     }
 
-
+    // 绘制二级列表项
-    //绘制二级列表
     @Override
     public View getChildView(final int groupPosition, final int childPosition, boolean isLastChild, View convertView, ViewGroup parent) {
         View view;
@@ -122,22 +137,24 @@ public class ExpandableListViewAdapter extends BaseExpandableListAdapter {
         childViewHolder.authorTv.setText(mAlbumCollectionList.get(groupPosition).get(childPosition).getSingerName());
         CommonUtil.setImgWithGlide(mContext,
                 mAlbumCollectionList.get(groupPosition).get(childPosition).getAlbumPic(), childViewHolder.faceIv);
-        //点击水波纹效果，结束后开始点击效果
+        // 点击水波纹效果，结束后开始点击效果
-        childViewHolder.childView.setOnRippleCompleteListener(rippleView -> mChildClickListener.onClick(groupPosition,childPosition));
+        childViewHolder.childView.setOnRippleCompleteListener(rippleView -> mChildClickListener.onClick(groupPosition, childPosition));
         return view;
     }
 
+    // 是否可以选择子项
     @Override
     public boolean isChildSelectable(int groupPosition, int childPosition) {
         return true;
     }
 
-
+    // 一级列表项的ViewHolder
     class GroupViewHolder {
         private TextView groupTextView;
         private ImageView pointIv;
     }
 
+    // 二级列表项的ViewHolder
     class ChildViewHolder {
         TextView albumNameTv;
         ImageView faceIv;

app/src/main/java/com/example/musicplayer/adapter/HistoryAdapter.java

@@ -19,35 +19,49 @@ import com.example.musicplayer.util.FileUtil;
 import java.util.List;
 
 /**
+ * HistoryAdapter 是一个 RecyclerView.Adapter 的扩展，用于展示用户播放历史的歌曲列表。
  * Created by 残渊 on 2018/12/2.
  */
-
 public class HistoryAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
     private static final String TAG = "HistoryAdapter";
-    private int footerViewType = 1;
+    private int footerViewType = 1; // 底部视图类型标识
-    private int itemViewType = 0;
+    private int itemViewType = 0; // 列表项视图类型标识
-    private List<HistorySong> mHistoryList;
+    private List<HistorySong> mHistoryList; // 播放历史歌曲列表
-    private Context mContext;
+    private Context mContext; // 上下文环境
-    private int mLastPosition = -1;
+    private int mLastPosition = -1; // 上一个被点击的位置
-    private OnItemClickListener onItemClickListener;
+    private OnItemClickListener onItemClickListener; // 点击事件监听器
 
+    /**
+     * 设置点击事件的监听器。
+     * @param onItemClickListener 点击事件监听器
+     */
     public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
         this.onItemClickListener = onItemClickListener;
     }
 
+    /**
+     * 构造函数，初始化上下文环境和播放历史歌曲列表。
+     * @param context 上下文环境
+     * @param historyList 播放历史歌曲列表
+     */
     public HistoryAdapter(Context context, List<HistorySong> historyList) {
         mContext = context;
-        mHistoryList =historyList;
+        mHistoryList = historyList;
     }
 
-
+    /**
-
+     * ViewHolder类，用于歌曲列表项。
+     */
     class ViewHolder extends RecyclerView.ViewHolder {
-        TextView songNameTv;
+        TextView songNameTv; // 歌曲名称
-        TextView singerTv;
+        TextView singerTv; // 歌手名称
-        RippleView mItemView;
+        RippleView mItemView; // 带有水波纹效果的视图
-        View playLine;
+        View playLine; // 播放线条，表示当前播放的歌曲
-
+
+        /**
+         * 构造函数，初始化歌曲列表项的视图。
+         * @param itemView 歌曲列表项的视图
+         */
         public ViewHolder(View itemView) {
             super(itemView);
             songNameTv = itemView.findViewById(R.id.tv_title);
@@ -58,18 +72,27 @@ public class HistoryAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder
     }
 
     /**
-     * 底部holder
+     * FooterHolder类，用于底部视图。
      */
     static class FooterHolder extends RecyclerView.ViewHolder {
+        TextView numTv; // 底部提示文本
 
-        TextView numTv;
+        /**
-
+         * 构造函数，初始化底部视图的视图。
+         * @param itemView 底部视图的视图
+         */
         public FooterHolder(View itemView) {
             super(itemView);
             numTv = itemView.findViewById(R.id.tv_song_num);
         }
     }
 
+    /**
+     * 创建新的ViewHolder实例。
+     * @param parent 父布局
+     * @param viewType 视图类型
+     * @return 返回对应的ViewHolder
+     */
     @Override
     public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
         if (viewType == itemViewType) {
@@ -85,6 +108,11 @@ public class HistoryAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder
         }
     }
 
+    /**
+     * 将数据绑定到ViewHolder上。
+     * @param viewHolder 当前ViewHolder
+     * @param position 当前位置
+     */
     @SuppressLint("SetTextI18n")
     @Override
     public void onBindViewHolder(RecyclerView.ViewHolder viewHolder, final int position) {
@@ -94,10 +122,10 @@ public class HistoryAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder
 
             holder.songNameTv.setText(history.getName());
             holder.singerTv.setText(history.getSinger());
-            //根据点击显示
+            // 根据当前播放的歌曲设置不同的显示效果
             if(history.getSongId().equals(FileUtil.getSong().getSongId())){
                 holder.playLine.setVisibility(View.VISIBLE);
-                mLastPosition =position;
+                mLastPosition = position;
                 holder.songNameTv.setTextColor(mContext.getResources()
                         .getColor(R.color.yellow));
                 holder.singerTv.setTextColor(mContext.getResources()
@@ -119,7 +147,10 @@ public class HistoryAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder
         }
     }
 
-    //判断点击的是否为上一个点击的项目
+    /**
+     * 处理点击事件，更新上一次点击的位置。
+     * @param position 当前点击的位置
+     */
     public void equalPosition(int position) {
         if (position != mLastPosition) {
             notifyItemChanged(mLastPosition);
@@ -128,11 +159,20 @@ public class HistoryAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder
         notifyItemChanged(position);
     }
 
+    /**
+     * 返回总的条目数，包括底部视图。
+     * @return 总条目数
+     */
     @Override
     public int getItemCount() {
         return mHistoryList.size() + 1;
     }
 
+    /**
+     * 根据位置返回不同的视图类型。
+     * @param position 位置
+     * @return 视图类型
+     */
     @Override
     public int getItemViewType(int position) {
         return position + 1 == getItemCount() ? footerViewType : itemViewType;

app/src/main/java/com/example/musicplayer/adapter/LoveSongAdapter.java

@@ -1,5 +1,7 @@
 package com.example.musicplayer.adapter;
 
+// 导入所需的包和类
+
 import android.annotation.SuppressLint;
 import android.content.Context;
 import android.support.annotation.NonNull;
@@ -19,38 +21,47 @@ import com.example.musicplayer.util.FileUtil;
 import java.util.List;
 
 /**
+ * 用于展示“喜欢的歌曲”列表的适配器。
+ * <p>
  * Created by 残渊 on 2018/11/30.
  */
-
 public class LoveSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
-    private static final String TAG = "LoveSongAdapter";
+    private static final String TAG = "LoveSongAdapter"; // 用于日志输出的标签
-    private int footerViewType = 1;
+    private int footerViewType = 1; // 底部视图类型标识
-    private int itemViewType = 0;
+    private int itemViewType = 0; // 列表项视图类型标识
-    private List<Love> mLoveList;
+    private List<Love> mLoveList; // 存储喜欢的歌曲数据
-    private Context mContext;
+    private Context mContext; // 上下文对象
-    private int mLastPosition = -1;
+    private int mLastPosition = -1; // 上一次点击的位置
-    private OnItemClickListener onItemClickListener;
+    private OnItemClickListener onItemClickListener; // 点击事件监听器
 
+    /**
+     * 设置点击事件监听器。
+     * @param onItemClickListener 点击事件监听器
+     */
     public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
         this.onItemClickListener = onItemClickListener;
     }
 
+    /**
+     * 构造函数，初始化上下文和喜欢的歌曲列表。
+     * @param context 上下文对象
+     * @param loveList 喜欢的歌曲列表
+     */
     public LoveSongAdapter(Context context, List<Love> loveList) {
         mContext = context;
         mLoveList = loveList;
     }
 
-
+    // ViewHolder，用于缓存视图，提高列表滚动性能
-
     class ViewHolder extends RecyclerView.ViewHolder {
-        TextView songNameTv;
+        TextView songNameTv; // 歌曲名称文本
-        TextView singerTv;
+        TextView singerTv; // 歌手文本
-        View playLine;
+        View playLine; // 播放线条视图
-        RippleView item;
+        RippleView item; // 带有水波纹效果的视图
 
         public ViewHolder(View itemView) {
             super(itemView);
-            songNameTv = itemView.findViewById(R.id.tv_title);
+            songNameTv = itemView.findViewById(R.id.tv_title); // 初始化视图
             singerTv = itemView.findViewById(R.id.tv_artist);
             playLine = itemView.findViewById(R.id.line_play);
             item = itemView.findViewById(R.id.ripple);
@@ -58,11 +69,10 @@ public class LoveSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolde
     }
 
     /**
-     * 底部holder
+     * 底部ViewHolder，用于显示底部信息。
      */
     static class FooterHolder extends RecyclerView.ViewHolder {
-
+        TextView numTv; // 底部信息文本
-        TextView numTv;
 
         public FooterHolder(View itemView) {
             super(itemView);
@@ -70,6 +80,12 @@ public class LoveSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolde
         }
     }
 
+    /**
+     * 创建新的ViewHolder。
+     * @param parent 父布局
+     * @param viewType 视图类型
+     * @return 返回对应的ViewHolder
+     */
     @Override
     public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
         if (viewType == itemViewType) {
@@ -85,6 +101,11 @@ public class LoveSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolde
         }
     }
 
+    /**
+     * 将数据绑定到ViewHolder。
+     * @param viewHolder 视图持有者
+     * @param position 位置
+     */
     @SuppressLint("SetTextI18n")
     @Override
     public void onBindViewHolder(RecyclerView.ViewHolder viewHolder, final int position) {
@@ -95,7 +116,7 @@ public class LoveSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolde
 
             holder.songNameTv.setText(love.getName());
             holder.singerTv.setText(love.getSinger());
-            //根据点击显示
+            // 根据歌曲是否正在播放显示不同的样式
             if (love.getSongId().equals(FileUtil.getSong().getSongId())) {
                 holder.playLine.setVisibility(View.VISIBLE);
                 mLastPosition = position;
@@ -122,7 +143,10 @@ public class LoveSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolde
         }
     }
 
-    //判断点击的是否为上一个点击的项目
+    /**
+     * 判断点击的是否为上一个点击的项目，如果是，则更新视图。
+     * @param position 当前点击的位置
+     */
     public void equalPosition(int position) {
         if (position != mLastPosition) {
             notifyItemChanged(mLastPosition);
@@ -131,11 +155,20 @@ public class LoveSongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolde
         notifyItemChanged(position);
     }
 
+    /**
+     * 获取列表项的总数。
+     * @return 列表项总数
+     */
     @Override
     public int getItemCount() {
-        return mLoveList.size() + 1;
+        return mLoveList.size() + 1; // 加1是为了显示底部视图
     }
 
+    /**
+     * 获取列表项的视图类型。
+     * @param position 位置
+     * @return 视图类型
+     */
     @Override
     public int getItemViewType(int position) {
         return position + 1 == getItemCount() ? footerViewType : itemViewType;

app/src/main/java/com/example/musicplayer/adapter/SearchContentAdapter.java

@@ -1,5 +1,7 @@
 package com.example.musicplayer.adapter;
 
+// 导入所需的包和类
+
 import android.content.Context;
 import android.support.annotation.NonNull;
 import android.support.v7.widget.RecyclerView;
@@ -25,30 +27,32 @@ import java.util.ArrayList;
 import java.util.List;
 
 /**
+ * 搜索内容适配器，用于展示搜索结果中的单曲和专辑列表。
  * Created by 残渊 on 2018/11/21.
  */
-
 public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
     private static final String TAG = "SearchContentAdapter";
 
-    private ArrayList<SearchSong.DataBean.SongBean.ListBean> mSongListBeans;
+    private ArrayList<SearchSong.DataBean.SongBean.ListBean> mSongListBeans; // 单曲列表数据
-    private List<Album.DataBean.AlbumBean.ListBean> mAlbumList;
+    private List<Album.DataBean.AlbumBean.ListBean> mAlbumList; // 专辑列表数据
-    private static OnItemClickListener mItemClick;
+    private static OnItemClickListener mItemClick; // 单曲点击事件监听器
-    private static OnAlbumItemClickListener mAlbumClick;
+    private static OnAlbumItemClickListener mAlbumClick; // 专辑点击事件监听器
-    private String mSeek;
+    private String mSeek; // 搜索关键字
-    private Context mContext;
+    private Context mContext; // 上下文对象
-    private int mLastPosition = -1;
+    private int mLastPosition = -1; // 上一次点击的位置
-    private int mType;
+    private int mType; // 列表类型，单曲或专辑
-
 
+    // 设置单曲点击事件监听器
     public static void setItemClick(OnItemClickListener itemClick) {
         mItemClick = itemClick;
     }
 
+    // 设置专辑点击事件监听器
     public static void setAlbumClick(OnAlbumItemClickListener albumClick) {
         mAlbumClick = albumClick;
     }
 
+    // 构造函数，初始化专辑搜索适配器
     public SearchContentAdapter(List<Album.DataBean.AlbumBean.ListBean> dataBeans, String seek, Context context, int type) {
         mContext = context;
         mSeek = seek;
@@ -56,7 +60,7 @@ public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.View
         mType = type;
     }
 
-
+    // 构造函数，初始化单曲搜索适配器
     public SearchContentAdapter(ArrayList<SearchSong.DataBean.SongBean.ListBean> songListBeans, String seek, Context context, int type) {
         mContext = context;
         mSeek = seek;
@@ -64,10 +68,11 @@ public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.View
         mType = type;
     }
 
+    // 创建ViewHolder
     @Override
     public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
         final View view;
-        if (viewType == Constant.TYPE_SONG ) {
+        if (viewType == Constant.TYPE_SONG) {
             view = LayoutInflater.from(parent.getContext())
                     .inflate(R.layout.recycler_song_search_item, parent, false);
             return new ViewHolder(view);
@@ -77,35 +82,37 @@ public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.View
             return new AlbumHolder(view);
         }
         return null;
-
     }
 
+    // 将数据绑定到ViewHolder
     @Override
     public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder, final int position) {
+        // 根据ViewHolder类型进行不同的数据处理
         if (holder instanceof ViewHolder) {
             ViewHolder songHolder = (ViewHolder) holder;
             SearchSong.DataBean.SongBean.ListBean songListBean = mSongListBeans.get(position);
 
-            //设置歌手，因为歌手可能有两个
+            // 设置歌手名称，可能存在多个歌手
             String singer = songListBean.getSinger().get(0).getName();
             for (int i = 1; i < songListBean.getSinger().size(); i++) {
-                singer+="、"+songListBean.getSinger().get(i).getName();
+                singer += "、" + songListBean.getSinger().get(i).getName();
             }
             songHolder.artistTv.setText(singer);
-            //设置与搜索一样的string的颜色
+            // 高亮显示搜索关键字
             CommonUtil.showStringColor(mSeek, singer, songHolder.artistTv);
             songHolder.titleTv.setText(songListBean.getSongname());
             CommonUtil.showStringColor(mSeek, songListBean.getSongname(), songHolder.titleTv);
 
-                //根据点击显示
+            // 根据歌曲是否正在播放显示不同的样式
-            if(songListBean.getSongmid().equals(FileUtil.getSong().getSongId())){
+            if (songListBean.getSongmid().equals(FileUtil.getSong().getSongId())) {
                 songHolder.playLine.setVisibility(View.VISIBLE);
-                mLastPosition =position;
+                mLastPosition = position;
                 songHolder.mItemView.setBackgroundResource(R.color.translucent);
-            }else {
+            } else {
                 songHolder.playLine.setVisibility(View.INVISIBLE);
                 songHolder.mItemView.setBackgroundResource(R.color.transparent);
             }
+            // 设置点击事件
             songHolder.mItemView.setOnRippleCompleteListener(rippleView -> {
                 mItemClick.onClick(position);
                 equalPosition(position);
@@ -113,21 +120,24 @@ public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.View
         } else {
             AlbumHolder albumHolder = (AlbumHolder) holder;
             Album.DataBean.AlbumBean.ListBean albumList = mAlbumList.get(position);
+            // 使用Glide加载专辑图片
             Glide.with(mContext).load(albumList.getAlbumPic())
                     .apply(RequestOptions.errorOf(R.drawable.background)).into(albumHolder.albumIv);
             albumHolder.albumName.setText(albumList.getAlbumName());
             albumHolder.singerName.setText(albumList.getSingerName());
             albumHolder.publicTime.setText(albumList.getPublicTime());
+            // 高亮显示搜索关键字
             CommonUtil.showStringColor(mSeek, albumList.getAlbumName(), albumHolder.albumName);
             CommonUtil.showStringColor(mSeek, albumList.getSingerName(), albumHolder.singerName);
             CommonUtil.showStringColor(mSeek, albumList.getPublicTime(), albumHolder.publicTime);
+            // 设置点击事件
             albumHolder.item.setOnRippleCompleteListener(rippleView -> {
                 mAlbumClick.onClick(position);
             });
         }
     }
 
-
+    // 获取列表项的总数
     @Override
     public int getItemCount() {
         if (mType == Constant.TYPE_SONG) {
@@ -138,6 +148,7 @@ public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.View
         return 0;
     }
 
+    // 内部类ViewHolder，用于单曲列表项
     class ViewHolder extends RecyclerView.ViewHolder {
         TextView titleTv;
         TextView artistTv;
@@ -153,6 +164,7 @@ public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.View
         }
     }
 
+    // 内部类AlbumHolder，用于专辑列表项
     class AlbumHolder extends RecyclerView.ViewHolder {
         ImageView albumIv;
         TextView singerName;
@@ -170,12 +182,13 @@ public class SearchContentAdapter extends RecyclerView.Adapter<RecyclerView.View
         }
     }
 
+    // 获取列表项的视图类型
     @Override
     public int getItemViewType(int position) {
         return mType;
     }
 
-    //判断点击的是否为上一个点击的项目
+    // 判断点击的是否为上一个点击的项目，并更新视图
     public void equalPosition(int position) {
         if (position != mLastPosition) {
             if (mLastPosition != -1) notifyItemChanged(mLastPosition);

app/src/main/java/com/example/musicplayer/adapter/SearchHistoryAdapter.java

@@ -1,5 +1,7 @@
 package com.example.musicplayer.adapter;
 
+// 导入所需的包和类
+
 import android.support.annotation.NonNull;
 import android.support.v7.widget.RecyclerView;
 import android.view.LayoutInflater;
@@ -18,64 +20,72 @@ import com.example.musicplayer.entiy.SearchHistory;
 import java.util.List;
 
 /**
- * 历史记录的适配器
+ * 历史记录的适配器，用于展示搜索历史列表。
  * Created by 残渊 on 2018/11/29.
  */
-
 public class SearchHistoryAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
-    private List<SearchHistory> mSearchHistoryList;
+    private List<SearchHistory> mSearchHistoryList; // 搜索历史列表数据
-    private static final int mHistoryType =0;
+    private static final int mHistoryType = 0; // 历史记录项的视图类型
-    private static final int mFooterType = 1;
+    private static final int mFooterType = 1; // 底部删除按钮的视图类型
-    private  OnItemClickListener mOnItemClickListener;
+    private OnItemClickListener mOnItemClickListener; // 列表项点击事件监听器
-    private  OnDeleteClickListener mOnDeleteClickListener;
+    private OnDeleteClickListener mOnDeleteClickListener; // 删除按钮点击事件监听器
-    private  OnFooterClickListener mFooterClickListener;
+    private OnFooterClickListener mFooterClickListener; // 底部删除所有按钮点击事件监听器
-
+
-    public SearchHistoryAdapter(List<SearchHistory> searchHistoryList){
+    // 构造函数，初始化搜索历史列表
+    public SearchHistoryAdapter(List<SearchHistory> searchHistoryList) {
         mSearchHistoryList = searchHistoryList;
     }
 
+    // 创建ViewHolder
     @NonNull
     @Override
     public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
-        if(viewType ==mHistoryType){
+        if (viewType == mHistoryType) {
-            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.recycler_seek_history_item,
+            // 历史记录项布局
-                    parent,false);
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.recycler_seek_history_item, parent, false);
             return new HistoryHolder(view);
-        }else{
+        } else {
-            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.footer_delete_all_history_item,
+            // 底部删除所有按钮布局
-                    parent,false);
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.footer_delete_all_history_item, parent, false);
             return new FooterHolder(view);
-
         }
     }
 
+    // 将数据绑定到ViewHolder
     @Override
     public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder, final int position) {
-        if(holder instanceof HistoryHolder){
+        if (holder instanceof HistoryHolder) {
-            HistoryHolder historyHolder =(HistoryHolder) holder;
+            HistoryHolder historyHolder = (HistoryHolder) holder;
+            // 设置历史记录文本
             historyHolder.historyTv.setText(mSearchHistoryList.get(position).getHistory());
+            // 设置删除按钮点击事件
             historyHolder.deleteIv.setOnClickListener(v -> mOnDeleteClickListener.onClick(position));
-
+            // 设置列表项点击事件
             historyHolder.mItemView.setOnRippleCompleteListener(rippleView -> mOnItemClickListener.onClick(position));
-        }else{
+        } else {
-            FooterHolder footerHolder =(FooterHolder) holder;
+            FooterHolder footerHolder = (FooterHolder) holder;
+            // 设置底部删除所有按钮点击事件
             footerHolder.deleteView.setOnClickListener(v -> mFooterClickListener.onClick());
         }
     }
 
+    // 获取列表项的总数
     @Override
     public int getItemCount() {
-        return mSearchHistoryList.size()+1;
+        return mSearchHistoryList.size() + 1; // 加1是为了显示底部删除所有按钮
     }
+
+    // 获取列表项的视图类型
     @Override
     public int getItemViewType(int position) {
-        return position + 1 == getItemCount() ? mFooterType :mHistoryType;
+        return position + 1 == getItemCount() ? mFooterType : mHistoryType;
     }
 
+    // 内部类HistoryHolder，用于历史记录列表项
     private class HistoryHolder extends RecyclerView.ViewHolder {
-        TextView historyTv;
+        TextView historyTv; // 历史记录文本
-        ImageView deleteIv;
+        ImageView deleteIv; // 删除按钮
-        RippleView mItemView;
+        RippleView mItemView; // 列表项背景
 
         public HistoryHolder(View itemView) {
             super(itemView);
@@ -85,8 +95,9 @@ public class SearchHistoryAdapter extends RecyclerView.Adapter<RecyclerView.View
         }
     }
 
+    // 内部类FooterHolder，用于底部删除所有按钮
     private class FooterHolder extends RecyclerView.ViewHolder {
-        View deleteView;
+        View deleteView; // 删除所有按钮
 
         public FooterHolder(View itemView) {
             super(itemView);
@@ -94,13 +105,18 @@ public class SearchHistoryAdapter extends RecyclerView.Adapter<RecyclerView.View
         }
     }
 
-    public  void setOnItemClickListener(OnItemClickListener onItemClcikListener){
+    // 设置列表项点击事件监听器
-        mOnItemClickListener =onItemClcikListener;
+    public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
+        mOnItemClickListener = onItemClickListener;
     }
-    public  void setOnDeleteClickListener(OnDeleteClickListener onDeleteClickListener){
+
-        mOnDeleteClickListener =onDeleteClickListener;
+    // 设置删除按钮点击事件监听器
+    public void setOnDeleteClickListener(OnDeleteClickListener onDeleteClickListener) {
+        mOnDeleteClickListener = onDeleteClickListener;
     }
-    public  void setFooterClickListener(OnFooterClickListener onFooterClickListener){
+
-        mFooterClickListener =onFooterClickListener;
+    // 设置底部删除所有按钮点击事件监听器
+    public void setFooterClickListener(OnFooterClickListener onFooterClickListener) {
+        mFooterClickListener = onFooterClickListener;
     }
 }

app/src/main/java/com/example/musicplayer/adapter/SongAdapter.java

@@ -1,5 +1,7 @@
 package com.example.musicplayer.adapter;
 
+// 导入所需的包和类
+
 import android.annotation.SuppressLint;
 import android.content.Context;
 import android.support.annotation.NonNull;
@@ -21,33 +23,35 @@ import java.util.List;
 import java.util.Objects;
 
 /**
+ * 歌曲列表的适配器，用于展示本地歌曲。
  * Created by 残渊 on 2018/10/10.
  */
-
 public class SongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
-    private static final String TAG = "SongAdapter";
+    private static final String TAG = "SongAdapter"; // 用于日志输出的标签
-    private int footerViewType = 1;
+    private int footerViewType = 1; // 底部视图类型标识
-    private int itemViewType = 0;
+    private int itemViewType = 0; // 列表项视图类型标识
-    private List<LocalSong> mMp3InfoList;
+    private List<LocalSong> mMp3InfoList; // 本地歌曲列表数据
-    private Context mContext;
+    private Context mContext; // 上下文对象
-    private int mLastPosition = -1;
+    private int mLastPosition = -1; // 上一次点击的位置
-    private OnItemClickListener onItemClickListener;
+    private OnItemClickListener onItemClickListener; // 点击事件监听器
-
+
+    // 设置点击事件监听器
     public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
         this.onItemClickListener = onItemClickListener;
     }
 
+    // 构造函数，初始化上下文和本地歌曲列表
     public SongAdapter(Context context, List<LocalSong> mp3InfoList) {
         mContext = context;
         mMp3InfoList = mp3InfoList;
     }
 
-
+    // 内部类ViewHolder，用于歌曲列表项
     static class ViewHolder extends RecyclerView.ViewHolder {
-        TextView songNameTv;
+        TextView songNameTv; // 歌曲名称文本
-        TextView artistTv;
+        TextView artistTv; // 歌手文本
-        ImageView playingIv;
+        ImageView playingIv; // 播放状态图标
-        RippleView songView;
+        RippleView songView; // 歌曲项背景
 
         public ViewHolder(View itemView) {
             super(itemView);
@@ -58,12 +62,9 @@ public class SongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
         }
     }
 
-    /**
+    // 底部holder
-     * 底部holder
-     */
     static class FooterHolder extends RecyclerView.ViewHolder {
-
+        TextView numTv; // 底部信息文本
-        TextView numTv;
 
         public FooterHolder(View itemView) {
             super(itemView);
@@ -71,6 +72,7 @@ public class SongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
         }
     }
 
+    // 创建ViewHolder
     @Override
     public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
         if (viewType == itemViewType) {
@@ -86,6 +88,7 @@ public class SongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
         }
     }
 
+    // 将数据绑定到ViewHolder
     @SuppressLint("SetTextI18n")
     @Override
     public void onBindViewHolder(RecyclerView.ViewHolder viewHolder, final int position) {
@@ -95,20 +98,20 @@ public class SongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
 
             holder.songNameTv.setText(mp3Info.getName());
             holder.artistTv.setText(mp3Info.getSinger());
-            //根据播放的歌曲是否为当前列表的歌曲显示
+            // 根据播放的歌曲是否为当前列表的歌曲显示
             String songId = Objects.requireNonNull(FileUtil.getSong()).getSongId();
-            if(songId!=null&&(mp3Info.getSongId().equals(songId))){
+            if (songId != null && mp3Info.getSongId().equals(songId)) {
-                holder.songNameTv.setTextColor(App.getContext().
+                holder.songNameTv.setTextColor(App.getContext()
-                        getResources().getColor(R.color.musicStyle_low));
+                        .getResources().getColor(R.color.musicStyle_low));
-                holder.artistTv.setTextColor(App.getContext().
+                holder.artistTv.setTextColor(App.getContext()
-                        getResources().getColor(R.color.musicStyle_low));
+                        .getResources().getColor(R.color.musicStyle_low));
                 holder.playingIv.setVisibility(View.VISIBLE);
                 mLastPosition = position;
-            }else {
+            } else {
-                holder.songNameTv.setTextColor(App.getContext().
+                holder.songNameTv.setTextColor(App.getContext()
-                        getResources().getColor(R.color.white));
+                        .getResources().getColor(R.color.white));
-                holder.artistTv.setTextColor(App.getContext().
+                holder.artistTv.setTextColor(App.getContext()
-                        getResources().getColor(R.color.white));
+                        .getResources().getColor(R.color.white));
                 holder.playingIv.setVisibility(View.GONE);
             }
             holder.songView.setOnRippleCompleteListener(rippleView -> {
@@ -117,11 +120,11 @@ public class SongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
             });
         } else {
             FooterHolder footerHolder = (FooterHolder) viewHolder;
-            footerHolder.numTv.setText("共" +mMp3InfoList.size()+ "首音乐");
+            footerHolder.numTv.setText("共" + mMp3InfoList.size() + "首音乐");
         }
     }
 
-    //判断点击的是否为上一个点击的项目
+    // 判断点击的是否为上一个点击的项目
     public void equalPosition(int position) {
         if (position != mLastPosition) {
             notifyItemChanged(mLastPosition);
@@ -130,17 +133,15 @@ public class SongAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
         notifyItemChanged(position);
     }
 
+    // 获取列表项的总数
     @Override
     public int getItemCount() {
-        return mMp3InfoList.size() + 1;
+        return mMp3InfoList.size() + 1; // 加1是为了显示底部视图
     }
 
+    // 获取列表项的视图类型
     @Override
     public int getItemViewType(int position) {
         return position + 1 == getItemCount() ? footerViewType : itemViewType;
     }
-
-
-
-
 }

app/src/main/java/com/example/musicplayer/adapter/TabAdapter.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.adapter;
 
+// 导入所需的包和类
 import android.support.v4.app.Fragment;
 import android.support.v4.app.FragmentManager;
 import android.support.v4.app.FragmentPagerAdapter;
@@ -7,29 +8,33 @@ import android.support.v4.app.FragmentPagerAdapter;
 import java.util.List;
 
 /**
+ * 顶部导航栏的适配器，用于为每个标签页提供对应的 Fragment。
  * Created by 残渊 on 2018/11/25.
  */
-
 public class TabAdapter extends FragmentPagerAdapter {
-    private List<Fragment> mFragmentList;//顶部导航栏的内容即fragment
+    private List<Fragment> mFragmentList; // 顶部导航栏的内容，即 Fragment 列表
-    private List<String> mTitle;//顶部导航栏的标题
+    private List<String> mTitle; // 顶部导航栏的标题列表
-
 
-    public TabAdapter(FragmentManager fragmentManager, List<Fragment>fragments, List<String>title){
+    // 构造函数，初始化 FragmentManager、Fragment 列表和标题列表
+    public TabAdapter(FragmentManager fragmentManager, List<Fragment> fragments, List<String> title) {
         super(fragmentManager);
-        mFragmentList=fragments;
+        mFragmentList = fragments;
-        mTitle=title;
+        mTitle = title;
-
     }
+
+    // 获取指定位置的 Fragment
     @Override
     public Fragment getItem(int position) {
         return mFragmentList.get(position);
     }
 
+    // 获取 Fragment 的总数
     @Override
     public int getCount() {
         return mFragmentList.size();
     }
+
+    // 获取指定位置的标题
     @Override
     public CharSequence getPageTitle(int position) {
         return mTitle.get(position);

app/src/main/java/com/example/musicplayer/app/Api.java

@@ -3,42 +3,41 @@ package com.example.musicplayer.app;
 import android.os.Environment;
 
 /**
+ * 提供音乐播放器应用中使用的各类API接口地址和常量。
  * Created by 残渊 on 2018/10/26.
  */
-
 public class Api {
-    //根据歌手获取歌手图片的baseUrl
+    // 根据歌手获取歌手图片的baseUrl
-    public static final String SINGER_PIC_BASE_URL ="http://music.163.com/";
+    public static final String SINGER_PIC_BASE_URL = "http://music.163.com/"; 
-    public static final String SINGER_PIC="api/search/get/web?csrf_token=&type=100";
+    public static final String SINGER_PIC = "api/search/get/web?csrf_token=&type=100";
-    //获取歌手图片需要添加user-agent的表头
+    // 获取歌手图片需要添加user-agent的表头
-    public static final String HEADER_USER_AGENT="User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.132 Safari/537.36";
+    public static final String HEADER_USER_AGENT = "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.132 Safari/537.36";
 
     /**
-     * 存取到手机内存的文件名
+     * 存储到手机内存的文件路径
      */
-    public static String STORAGE_IMG_FILE= App.getContext().getExternalFilesDir("") + "/yuanmusic/img/";
+    public static String STORAGE_IMG_FILE = App.getContext().getExternalFilesDir("") + "/yuanmusic/img/";
-    public static String STORAGE_LRC_FILE= App.getContext().getExternalFilesDir("") + "/yuanmusic/lrc/";
+    public static String STORAGE_LRC_FILE = App.getContext().getExternalFilesDir("") + "/yuanmusic/lrc/";
-    public static String STORAGE_SONG_FILE= Environment.getExternalStorageDirectory() + "/Sxmusic/download/";
+    public static String STORAGE_SONG_FILE = Environment.getExternalStorageDirectory() + "/Sxmusic/download/";
-
-    //Fiddler抓包qq音乐网站后的地址
-    public static final String FIDDLER_BASE_QQ_URL ="https://c.y.qq.com/";
-    public static final String FIDDLER_BASE_SONG_URL="https://u.y.qq.com/"; //获取播放地址的baseUrl
-    //搜索功能
-    public static final String SEARCH_SONG ="soso/fcgi-bin/client_search_cp?n=30&format=json"; //歌曲，n为一页30首
-    public static final String SEARCH_ALBUM="soso/fcgi-bin/client_search_cp?n=20&format=json&t=8";//专辑，n为一页20张
-    //得到歌曲的播放地址
-    public static final String SONG_URL="cgi-bin/musicu.fcg?format=json";
-    public static final String SONG_URL_DATA_LEFT="%7B%22req_0%22%3A%7B%22module%22%3A%22vkey.GetVkeyServer%22%2C%22method%22%3A%22CgiGetVkey%22%2C%22param%22%3A%7B%22guid%22%3A%22358840384%22%2C%22songmid%22%3A%5B%22";
-    public static final String SONG_URL_DATA_RIGHT="%22%5D%2C%22songtype%22%3A%5B0%5D%2C%22uin%22%3A%221443481947%22%2C%22loginflag%22%3A1%2C%22platform%22%3A%2220%22%7D%7D%2C%22comm%22%3A%7B%22uin%22%3A%221443481947%22%2C%22format%22%3A%22json%22%2C%22ct%22%3A24%2C%22cv%22%3A0%7D%7D";
-    public static final String MP4 =".mp4";
-    //专辑照片
-    public static final String ALBUM_PIC="http://y.gtimg.cn/music/photo_new/T002R180x180M000";
-    public static final String JPG=".jpg";
-    //专辑详细
-    public static final String ALBUM_DETAIL="v8/fcg-bin/fcg_v8_album_info_cp.fcg?format=json";
-    //歌词
-    public static final String SONG_LRC ="soso/fcgi-bin/client_search_cp?p=1&n=30&format=json&t=7";//搜索歌词
-    public static final String ONLINE_SONG_LRC="https://c.y.qq.com/lyric/fcgi-bin/fcg_query_lyric_new.fcg?format=json&nobase64=1";//根据qq音乐的mid获取歌词
-    public static final String HEADER_REFERER="Referer:https://y.qq.com/portal/player.html";//得到歌词需要添加Referer的表头
 
+    // Fiddler抓包qq音乐网站后的地址
+    public static final String FIDDLER_BASE_QQ_URL = "https://c.y.qq.com/"; 
+    public static final String FIDDLER_BASE_SONG_URL = "https://u.y.qq.com/";  // 获取播放地址的baseUrl
+    // 搜索功能
+    public static final String SEARCH_SONG = "soso/fcgi-bin/client_search_cp?n=30&format=json"; // 歌曲，n为一页30首
+    public static final String SEARCH_ALBUM = "soso/fcgi-bin/client_search_cp?n=20&format=json&t=8"; // 专辑，n为一页20张
+    // 得到歌曲的播放地址
+    public static final String SONG_URL = "cgi-bin/musicu.fcg?format=json";
+    public static final String SONG_URL_DATA_LEFT = "%7B%22req_0%22%3A%7B%22module%22%3A%22vkey.GetVkeyServer%22%2C%22method%22%3A%22CgiGetVkey%22%2C%22param%22%3A%7B%22guid%22%3A%22358840384%22%2C%22songmid%22%3A%5B%22";
+    public static final String SONG_URL_DATA_RIGHT = "%22%5D%2C%22songtype%22%3A%5B0%5D%2C%22uin%22%3A%221443481947%22%2C%22loginflag%22%3A1%2C%22platform%22%3A%2220%22%7D%7D%2C%22comm%22%3A%7B%22uin%22%3A%221443481947%22%2C%22format%22%3A%22json%22%2C%22ct%22%3A24%2C%22cv%22%3A0%7D%7D";
+    public static final String MP4 = ".mp4";
+    // 专辑照片
+    public static final String ALBUM_PIC = "http://y.gtimg.cn/music/photo_new/T002R180x180M000"; 
+    public static final String JPG = ".jpg";
+    // 专辑详细
+    public static final String ALBUM_DETAIL = "v8/fcg-bin/fcg_v8_album_info_cp.fcg?format=json";
+    // 歌词
+    public static final String SONG_LRC = "soso/fcgi-bin/client_search_cp?p=1&n=30&format=json&t=7"; // 搜索歌词
+    public static final String ONLINE_SONG_LRC = "https://c.y.qq.com/lyric/fcgi-bin/fcg_query_lyric_new.fcg?format=json&nobase64=1"; // 根据qq音乐的mid获取歌词 
+    public static final String HEADER_REFERER = "Referer:https://y.qq.com/portal/player.html"; // 得到歌词需要添加Referer的表头 
 }

app/src/main/java/com/example/musicplayer/app/App.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.app;
 
+// 导入所需的包和类
 import android.annotation.SuppressLint;
 import android.app.Application;
 import android.content.Context;
@@ -7,22 +8,30 @@ import android.content.Context;
 import org.litepal.LitePal;
 
 /**
- * 获取全局Context
+ * 应用全局上下文类，用于获取全局Context实例。
+ * <p>
  * Created by 残渊 on 2018/7/17.
  */
-
 public class App extends Application {
+    // 使用SuppressLint注解来抑制静态字段可能引起的内存泄漏警告
     @SuppressLint("StaticFieldLeak")
-    private static Context context;
+    private static Context context; // 静态变量，用于存储全局Context对象
 
+    /**
+     * 在应用创建时初始化全局Context和LitePal数据库。
+     */
     @Override
-    public void onCreate(){
+    public void onCreate() {
-        super.onCreate();
+        super.onCreate(); // 调用父类的onCreate方法
-        context=getApplicationContext();
+        context = getApplicationContext(); // 初始化全局Context对象
-        LitePal.initialize(this);
+        LitePal.initialize(this); // 初始化LitePal数据库
     }
 
-    public static Context getContext(){
+    /**
+     * 提供全局Context对象的获取方法。
+     * @return 返回全局Context对象
+     */
+    public static Context getContext() {
         return context;
     }
 }

app/src/main/java/com/example/musicplayer/app/Constant.java

@@ -1,82 +1,82 @@
 package com.example.musicplayer.app;
 
 /**
+ * 定义应用中使用的常量类。
  * Created by 残渊 on 2018/11/23.
  */
-
 public class Constant {
+    // 日志标签
     public static final String TAG = "jsyjst";
 
+    // 分页加载的偏移量
     public static final int OFFSET = 30;
+    // 类型常量，用于区分歌曲和专辑
     public static final int TYPE_SONG = 1;
     public static final int TYPE_ALBUM = 2;
 
-    //播放列表
+    // 播放列表类型
-    public static final int LIST_TYPE_LOCAL = 1;   //本地列表
+    public static final int LIST_TYPE_LOCAL = 1;   // 本地列表
-    public static final int LIST_TYPE_ONLINE = 2;  //专辑列表
+    public static final int LIST_TYPE_ONLINE = 2;  // 专辑列表
-    public static final int LIST_TYPE_LOVE = 3;    //我的收藏列表
+    public static final int LIST_TYPE_LOVE = 3;    // 我的收藏列表
-    public static final int LIST_TYPE_HISTORY = 4;  //最近播放列表
+    public static final int LIST_TYPE_HISTORY = 4;  // 最近播放列表
-    public static final int LIST_TYPE_DOWNLOAD = 5; //下载列表
+    public static final int LIST_TYPE_DOWNLOAD = 5; // 下载列表
 
+    // 搜索历史最大条目数
     public static final int HISTORY_MAX_SIZE = 100;
 
-
+    // 布局状态常量
-    //布局
     public static final int NORMAL_STATE = 0;
     public static final int LOADING_STATE = 1;
     public static final int ERROR_STATE = 2;
 
-    //playerStatus
+    // 播放器状态常量
     public static final String PLAYER_STATUS = "PlayerStatus";
     public static final int SONG_PLAY = 0;
     public static final int SONG_PAUSE = 1;
     public static final int SONG_RESUME = 2;
     public static final int SONG_CHANGE = 3;
 
-
+    // 键值对常量
-    //KEY
     public static final String ALBUM_ID_KEY = "id";
     public static final String ALBUM_NAME_KEY = "albumName";
     public static final String SINGER_NAME_KEY = "singerName";
     public static final String ALBUM_PIC_KEY = "albumPic";
     public static final String PUBLIC_TIME_KEY = "publicTime";
 
-
+    // 错误标签
-    //TAG
     public static final String TAG_ERROR = "error";
 
-    //网络与非网络歌曲
+    // 网络与非网络歌曲标识
     public static final int SONG_ONLINE = 0;
     public static final int SONG_LOCAL = 1;
 
-
+    // 后缀常量
-    //后缀
     public static final String LRC = ".lrc";
 
-    //音乐id
+    // 音乐id未找到标识
     public static final String SONG_ID_UNFIND = "unFind";
 
-    //播放顺序
+    // 播放顺序常量
-    public static final int PLAY_ORDER = 0;//顺序播放
+    public static final int PLAY_ORDER = 0; // 顺序播放
-    public static final int PLAY_SINGLE = 1;//单曲循环
+    public static final int PLAY_SINGLE = 1; // 单曲循环
-    public static final int PLAY_RANDOM = 2;//随机播放
+    public static final int PLAY_RANDOM = 2; // 随机播放
 
-    //Preferences
+    // Preferences常量
     public static final String SHARED_PREFERENCES_NAME = "prefs";
-    public static final String PREFS_PLAY_MODE = "play_mode";//播放状态
+    public static final String PREFS_PLAY_MODE = "play_mode"; // 播放模式
 
-    //download
+    // 下载状态常量
     public final static int TYPE_DOWNLOADING = 0;
     public final static int TYPE_DOWNLOAD_PAUSED = 1;
     public final static int TYPE_DOWNLOAD_CANCELED = 2;
     public final static int TYPE_DOWNLOAD_SUCCESS = 3;
     public final static int TYPE_DOWNLOAD_FAILED = 4;
     public final static int TYPE_DOWNLOADED = 5;
-    public final static int TYPE_DOWNLOAD_ADD=6;
+    public final static int TYPE_DOWNLOAD_ADD = 6;
 
-    //正在下载歌曲列表的状态
+    // 正在下载歌曲列表的状态常量
     public final static int DOWNLOAD_PAUSED = 0;
-    public final static int DOWNLOAD_WAIT=1;
+    public final static int DOWNLOAD_WAIT = 1;
-    public final static int DOWNLOAD_ING=2;
+    public final static int DOWNLOAD_ING = 2;
-    public final static int DOWNLOAD_READY=3;
+    public final static int DOWNLOAD_READY = 3;
 }

app/src/main/java/com/example/musicplayer/base/activity/BaseActivity.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.base.activity;
 
+// 导入所需的包和类
 import android.os.Bundle;
 import android.support.annotation.Nullable;
 import android.support.v7.app.AppCompatActivity;
@@ -12,63 +13,68 @@ import butterknife.ButterKnife;
 import butterknife.Unbinder;
 
 /**
- * <pre>
+ * 所有活动的基类，提供了基本的初始化操作和视图绑定。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/17
+ * author : 残渊
- *     desc   : 所有活动的基类
+ * time   : 2019/07/17
- * </pre>
+ * desc   : 所有活动的基类
  */
-
 public abstract class BaseActivity extends AppCompatActivity implements BaseView {
 
-    private Unbinder mBinder;
+    private Unbinder mBinder; // ButterKnife绑定对象，用于解绑
 
-    protected abstract int getLayoutId(); //获取布局id
+    // 获取布局id
-    protected abstract void initView(); //初始化布局
+    protected abstract int getLayoutId(); 
-    protected abstract void initData(); //初始化数据
+    // 初始化布局
-    protected abstract void onClick();//点击事件
+    protected abstract void initView(); 
+    // 初始化数据
+    protected abstract void initData(); 
+    // 点击事件
+    protected abstract void onClick();
 
     @Override
     protected void onCreate(@Nullable Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        setContentView(getLayoutId());
+        setContentView(getLayoutId()); // 设置布局
-        ButterKnife.bind(this);
+        ButterKnife.bind(this); // 绑定视图
-        initView();
+        initView(); // 初始化视图
-        initData();
+        initData(); // 初始化数据
-        onClick();
+        onClick(); // 点击事件
     }
 
     @Override
     protected void onDestroy() {
         super.onDestroy();
+        // 解绑ButterKnife，避免内存泄漏
         if(mBinder != null && mBinder != mBinder.EMPTY){
             mBinder.unbind();
             mBinder = null;
         }
     }
 
+    // 显示提示信息
     @Override
     public void showToast(String message) {
-        CommonUtil.showToast(this,message);
+        CommonUtil.showToast(this, message);
     }
 
+    // 显示正常视图
     @Override
     public void showNormalView() {
-
     }
 
+    // 显示错误视图
     @Override
     public void showErrorView() {
-
     }
 
+    // 显示加载视图
     @Override
     public void showLoading() {
-
     }
 
+    // 重新加载数据
     @Override
     public void reload() {
-
     }
 }

app/src/main/java/com/example/musicplayer/base/activity/BaseMvpActivity.java

@@ -3,29 +3,36 @@ package com.example.musicplayer.base.activity;
 import com.example.musicplayer.base.presenter.IPresenter;
 
 /**
- * <pre>
+ * MVP架构中的基Activity类，用于所有采用MVP模式的Activity。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/17
+ * author : 残渊
- *     desc   :
+ * time   : 2019/07/17
- * </pre>
+ * desc   : 提供了Presenter的绑定和解绑操作。
  */
-
+public abstract class BaseMvpActivity<T extends IPresenter> extends BaseActivity {
-public abstract class BaseMvpActivity<T extends IPresenter> extends BaseActivity{
+    // 抽象方法，用于获取具体的Presenter实例
     protected abstract T getPresenter();
+    // Presenter成员变量，用于与View进行交互
     protected T mPresenter;
 
+    /**
+     * 初始化视图，包括绑定Presenter。
+     */
     @Override
     protected void initView() {
-        mPresenter = getPresenter();
+        mPresenter = getPresenter(); // 获取Presenter实例
-        mPresenter.attachView(this);
+        mPresenter.attachView(this); // 将当前Activity绑定到Presenter的View
     }
 
+    /**
+     * 在Activity销毁时解绑Presenter，并置空引用。
+     */
     @Override
     protected void onDestroy() {
-        super.onDestroy();
+        super.onDestroy(); // 调用父类的onDestroy方法
-        if(mPresenter != null){
+        if (mPresenter != null) {
-            mPresenter.detachView();
+            mPresenter.detachView(); // 从Presenter解绑当前Activity的View
-            mPresenter = null;
+            mPresenter = null; // 置空引用，避免内存泄漏
         }
     }
 }

app/src/main/java/com/example/musicplayer/base/fragment/BaseFragment.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.base.fragment;
 
+// 导入所需的包和类
 import android.app.Activity;
 import android.content.Context;
 import android.os.Bundle;
@@ -16,75 +17,92 @@ import butterknife.ButterKnife;
 import butterknife.Unbinder;
 
 /**
- * <pre>
+ * 所有Fragment的基类，提供了基本的初始化操作和视图绑定。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/14
+ * author : 残渊
- *     desc   :
+ * time   : 2019/07/14
- * </pre>
+ * desc   : 基Fragment类，用于简化Fragment的创建和视图管理。
  */
-
 public abstract class BaseFragment extends BaseLazyFragment implements BaseView {
-    private Unbinder mBinder;
+    private Unbinder mBinder; // ButterKnife绑定对象，用于解绑
-    protected Activity mActivity;
+    protected Activity mActivity; // 引用Activity，方便调用Activity的方法
-    protected abstract void initView(); //初始化控件
+
-    protected abstract void loadData(); //加载数据
+    // 初始化控件的抽象方法
-    protected abstract int getLayoutId(); //获取Fragment的布局id
+    protected abstract void initView();
-
+    // 加载数据的抽象方法
+    protected abstract void loadData();
+    // 获取Fragment的布局id的抽象方法
+    protected abstract int getLayoutId();
+
+    /**
+     * 当Fragment附加到Activity时调用，保存Activity的引用。
+     * @param context 上下文对象
+     */
     @Override
     public void onAttach(Context context) {
         super.onAttach(context);
         mActivity = (Activity) context;
     }
 
+    /**
+     * 创建视图，通过LayoutInflater加载布局，并使用ButterKnife进行视图绑定。
+     * @param inflater 布局填充器
+     * @param container 容器
+     * @param savedInstanceState 保存的实例状态
+     * @return 返回Fragment的视图
+     */
     @Nullable
     @Override
     public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
-        View view = inflater.inflate(getLayoutId(),container,false);
+        View view = inflater.inflate(getLayoutId(), container, false);
-        mBinder = ButterKnife.bind(this,view);
+        mBinder = ButterKnife.bind(this, view);
         initView();
         return view;
     }
 
-
+    /**
+     * 当视图销毁时解绑ButterKnife，避免内存泄漏。
+     */
     @Override
     public void onDestroyView() {
         super.onDestroyView();
-        if(mBinder != null && mBinder != Unbinder.EMPTY){
+        if (mBinder != null && mBinder != Unbinder.EMPTY) {
             mBinder.unbind();
             mBinder = null;
         }
     }
 
-
+    /**
+     * 懒加载数据，仅当Fragment对用户可见时加载数据。
+     */
     @Override
     protected void lazyLoadData() {
         loadData();
     }
 
+    // 实现BaseView接口的方法，但未具体实现，子类可根据需要实现
     @Override
     public void showNormalView() {
-
     }
 
     @Override
     public void showErrorView() {
-
     }
 
     @Override
     public void showLoading() {
-
     }
 
     @Override
     public void reload() {
-
     }
 
+    /**
+     * 显示提示信息，使用CommonUtil工具类简化提示信息的显示。
+     * @param message 提示信息
+     */
     @Override
     public void showToast(String message) {
-        CommonUtil.showToast(mActivity,message);
+        CommonUtil.showToast(mActivity, message);
     }
-
-
 }

app/src/main/java/com/example/musicplayer/base/fragment/BaseLazyFragment.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.base.fragment;
 
+// 导入所需的包和类
 import android.os.Bundle;
 import android.support.annotation.NonNull;
 import android.support.annotation.Nullable;
@@ -8,74 +9,95 @@ import android.util.Log;
 import android.view.View;
 
 /**
- * <pre>
+ * 实现懒加载机制的Fragment基类。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/14
+ * author : 残渊
- *     desc   : 实现懒加载的Fragment
+ * time   : 2019/07/14
- * </pre>
+ * desc   : 提供懒加载数据的逻辑，确保数据只在Fragment对用户可见时加载。
  */
-
 public abstract class BaseLazyFragment extends Fragment {
-    private boolean isViewCreated = false;//布局是否被创建
+    private boolean isViewCreated = false; // 标记布局是否已被创建
-    private boolean isLoadData = false;//数据是否加载
+    private boolean isLoadData = false; // 标记数据是否已加载
-    private boolean isFirstVisible = true;//是否第一次可见
+    private boolean isFirstVisible = true; // 标记是否是第一次可见
-    private static final String TAG = "BaseLazyFragment";
+    private static final String TAG = "BaseLazyFragment"; // 日志标签
 
-    protected abstract void lazyLoadData(); //加载数据
+    // 抽象方法，用于子类实现具体的懒加载数据逻辑
+    protected abstract void lazyLoadData();
 
+    /**
+     * 当Fragment的视图被创建后调用，标记布局已被创建。
+     * @param view 视图
+     * @param savedInstanceState 保存的实例状态
+     */
     @Override
     public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
+        super.onViewCreated(view, savedInstanceState);
         isViewCreated = true;
     }
 
+    /**
+     * 当Fragment的活动被创建后调用，如果Fragment可见且数据未加载，则加载数据。
+     * @param savedInstanceState 保存的实例状态
+     */
     @Override
     public void onActivityCreated(@Nullable Bundle savedInstanceState) {
         super.onActivityCreated(savedInstanceState);
-        if(isFragmentVisible(this)){
+        if (isFragmentVisible(this)) {
             if (this.getParentFragment() == null || isFragmentVisible(this.getParentFragment())) {
                 Log.d(TAG, "onActivityCreated: 加载数据");
                 lazyLoadData();
                 isLoadData = true;
-                if(isFirstVisible) isFirstVisible = false;
+                if (isFirstVisible) isFirstVisible = false;
             }
         }
     }
 
-    //在使用ViewPage时，加载数据
+    /**
+     * 当Fragment的可见性发生变化时调用，如果Fragment可见且数据未加载且布局已创建，则加载数据。
+     * @param isVisibleToUser 是否对用户可见
+     */
     @Override
     public void setUserVisibleHint(boolean isVisibleToUser) {
         super.setUserVisibleHint(isVisibleToUser);
-        if(isFragmentVisible(this)&& !isLoadData && isViewCreated){
+        if (isFragmentVisible(this) && !isLoadData && isViewCreated) {
             lazyLoadData();
             isLoadData = true;
         }
     }
 
-
+    /**
-    //调用show方法时加载数据
+     * 当Fragment的隐藏状态发生变化时调用，如果Fragment不再隐藏且数据未加载且是第一次可见，则加载数据。
+     * @param hidden 是否被隐藏
+     */
     @Override
     public void onHiddenChanged(boolean hidden) {
         super.onHiddenChanged(hidden);
-        //onHiddenChanged调用在Resumed之前，所以此时可能fragment被add, 但还没调用show方法
+        if (!hidden && !this.isResumed())
-        if(!hidden && !this.isResumed())
             return;
-        //使用hide和show时，fragment的所有生命周期方法都不会调用，除了onHiddenChanged（）
+        if (!hidden && isFirstVisible) {
-        if(!hidden && isFirstVisible){
             Log.d(TAG, "onHiddenChanged: 加载数据");
             lazyLoadData();
             isFirstVisible = false;
         }
     }
 
+    /**
+     * 判断Fragment是否可见。
+     * @param fragment Fragment对象
+     * @return 是否可见
+     */
     private boolean isFragmentVisible(Fragment fragment){
-        return fragment.getUserVisibleHint()&&!fragment.isHidden();
+        return fragment.getUserVisibleHint() && !fragment.isHidden();
     }
 
+    /**
+     * 当视图销毁时重置标记。
+     */
     @Override
     public void onDestroyView() {
         super.onDestroyView();
         isFirstVisible = true;
         isLoadData = false;
-        isViewCreated =false;
+        isViewCreated = false;
     }
 }

app/src/main/java/com/example/musicplayer/base/fragment/BaseLoadingFragment.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.base.fragment;
 
+// 导入所需的包和类
 import android.os.Bundle;
 import android.support.annotation.NonNull;
 import android.support.annotation.Nullable;
@@ -16,100 +17,120 @@ import static com.example.musicplayer.app.Constant.LOADING_STATE;
 import static com.example.musicplayer.app.Constant.NORMAL_STATE;
 
 /**
- * <pre>
+ * 带有加载、错误和正常状态视图的MVP基Fragment类。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/15
+ * author : 残渊
- *     desc   :
+ * time   : 2019/07/15
- * </pre>
+ * desc   : 提供了三种状态视图的切换逻辑，包括加载中、错误和正常显示。
  */
-
 public abstract class BaseLoadingFragment<T extends IPresenter> extends BaseMvpFragment<T> {
-    private View mNormalView;  //正常布局
+    private View mNormalView;  // 正常布局
-    private View mErrorView; //错误布局
+    private View mErrorView;   // 错误布局
-    private View mLoadingView;//加载布局
+    private View mLoadingView; // 加载布局
-    private AVLoadingIndicatorView avLoadingView;
+    private AVLoadingIndicatorView avLoadingView; // 加载动画视图
-
+
-    private int mCurrentState = NORMAL_STATE;//当前布局状态
+    private int mCurrentState = NORMAL_STATE; // 当前视图状态
-
+
+    /**
+     * 当Fragment的视图创建完成后调用，初始化三种状态的视图。
+     * @param view 视图
+     * @param savedInstanceState 保存的实例状态
+     */
     @Override
     public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
         super.onViewCreated(view, savedInstanceState);
-        if(getView() == null) return;
+        if (getView() == null) return;
         mNormalView = view.findViewById(R.id.normalView);
-        if(mNormalView == null){
+        if (mNormalView == null) {
             throw new IllegalStateException("The subclass of BaseLoadFragment must contain a View it's id is named normal_view");
         }
-        if(!(mNormalView.getParent() instanceof ViewGroup)){
+        if (!(mNormalView.getParent() instanceof ViewGroup)) {
             throw new IllegalStateException("mNormalView's parentView should be a ViewGroup");
         }
 
         ViewGroup parentPanel = (ViewGroup) mNormalView.getParent();
-        View.inflate(mActivity,R.layout.error_view,parentPanel); //加载错误布局
+        View.inflate(mActivity, R.layout.error_view, parentPanel); // 加载错误布局
-        View.inflate(mActivity,R.layout.loading_view,parentPanel);//加载loading布局
+        View.inflate(mActivity, R.layout.loading_view, parentPanel); // 加载加载布局
 
         mLoadingView = parentPanel.findViewById(R.id.loadingView);
         avLoadingView = parentPanel.findViewById(R.id.avLoading);
         mErrorView = parentPanel.findViewById(R.id.errorView);
         TextView reloadBtn = parentPanel.findViewById(R.id.reloadBtn);
-        reloadBtn.setOnClickListener(view1 -> reload()); //重新加载
+        reloadBtn.setOnClickListener(view1 -> reload()); // 设置重新加载按钮的点击事件
 
         mNormalView.setVisibility(View.VISIBLE);
         mErrorView.setVisibility(View.GONE);
         mLoadingView.setVisibility(View.GONE);
     }
 
+    /**
+     * 显示正常视图，并隐藏其他视图。
+     */
     @Override
     public void showNormalView() {
         super.showNormalView();
-        if(mCurrentState == NORMAL_STATE) return;
+        if (mCurrentState == NORMAL_STATE) return;
         hideViewByState(mCurrentState);
         mCurrentState = NORMAL_STATE;
         showViewByState(mCurrentState);
     }
 
+    /**
+     * 显示错误视图，并隐藏其他视图。
+     */
     @Override
     public void showErrorView() {
         super.showErrorView();
-        if(mCurrentState == ERROR_STATE) return;
+        if (mCurrentState == ERROR_STATE) return;
         hideViewByState(mCurrentState);
         mCurrentState = ERROR_STATE;
         showViewByState(mCurrentState);
     }
 
+    /**
+     * 显示加载视图，并隐藏其他视图。
+     */
     @Override
     public void showLoading() {
         super.showLoading();
-        if(mCurrentState == LOADING_STATE) return;
+        if (mCurrentState == LOADING_STATE) return;
         hideViewByState(mCurrentState);
         mCurrentState = LOADING_STATE;
         showViewByState(mCurrentState);
     }
 
-    private void hideViewByState(int state){
+    /**
-        if(state == NORMAL_STATE){
+     * 根据状态隐藏视图。
-            if(mNormalView == null) return;
+     * @param state 视图状态
+     */
+    private void hideViewByState(int state) {
+        if (state == NORMAL_STATE) {
+            if (mNormalView == null) return;
             mNormalView.setVisibility(View.GONE);
-        }else if(state == LOADING_STATE){
+        } else if (state == LOADING_STATE) {
-            if(mLoadingView == null||avLoadingView == null) return;
+            if (mLoadingView == null || avLoadingView == null) return;
-             mLoadingView.setVisibility(View.GONE);
+            mLoadingView.setVisibility(View.GONE);
-        }else {
+        } else {
-            if(mErrorView == null ) return;
+            if (mErrorView == null) return;
             mErrorView.setVisibility(View.GONE);
         }
     }
-    private void showViewByState(int state){
+
-        if(state == NORMAL_STATE){
+    /**
-            if(mNormalView == null) return;
+     * 根据状态显示视图。
+     * @param state 视图状态
+     */
+    private void showViewByState(int state) {
+        if (state == NORMAL_STATE) {
+            if (mNormalView == null) return;
             mNormalView.setVisibility(View.VISIBLE);
-        }else if(state == LOADING_STATE){
+        } else if (state == LOADING_STATE) {
-            if(mLoadingView == null||avLoadingView == null) return;
+            if (mLoadingView == null || avLoadingView == null) return;
             mLoadingView.setVisibility(View.VISIBLE);
-            avLoadingView.show();
+            avLoadingView.show(); // 显示加载动画
-        }else {
+        } else {
-            if(mErrorView == null ) return;
+            if (mErrorView == null) return;
             mErrorView.setVisibility(View.VISIBLE);
         }
     }
-
-
 }

app/src/main/java/com/example/musicplayer/base/fragment/BaseMvpFragment.java

@@ -1,31 +1,39 @@
 package com.example.musicplayer.base.fragment;
 
+// 导入所需的包和类
 import com.example.musicplayer.base.presenter.IPresenter;
 
 /**
- * <pre>
+ * MVP模式下Fragment的基类。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/14
+ * author : 残渊
- *     desc   : Mvp模式Fragment的基类
+ * time   : 2019/07/14
- * </pre>
+ * desc   : 提供了Presenter的绑定和解绑操作，用于MVP架构的Fragment。
  */
-
 public abstract class BaseMvpFragment<T extends IPresenter> extends BaseFragment {
+    // 抽象方法，用于获取具体的Presenter实例
     protected abstract T getPresenter();
+    // Presenter成员变量，用于与View进行交互
     protected T mPresenter;
 
+    /**
+     * 初始化视图，包括绑定Presenter。
+     */
     @Override
     protected void initView() {
-        mPresenter = getPresenter();
+        mPresenter = getPresenter(); // 获取Presenter实例
-        mPresenter.attachView(this);
+        mPresenter.attachView(this); // 将当前Fragment绑定到Presenter的View
     }
 
+    /**
+     * 在Fragment销毁时解绑Presenter，并置空引用。
+     */
     @Override
     public void onDestroy() {
-        if(mPresenter != null){
+        if (mPresenter != null) {
-            mPresenter.detachView();
+            mPresenter.detachView(); // 从Presenter解绑当前Fragment的View
-            mPresenter = null;
+            mPresenter = null; // 置空引用，避免内存泄漏
         }
-        super.onDestroy();
+        super.onDestroy(); // 调用父类的onDestroy方法
     }
 }

app/src/main/java/com/example/musicplayer/base/observer/BaseObserver.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.base.observer;
 
+// 导入所需的包和类
 import android.net.ParseException;
 import android.os.Handler;
 import android.util.Log;
@@ -19,57 +20,69 @@ import retrofit2.HttpException;
 import static com.example.musicplayer.app.Constant.TAG_ERROR;
 
 /**
- * <pre>
+ * 对RxJava的下游即数据进行处理的基类。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/16
+ * author : 残渊
- *     desc   : 对RxJava的下游即数据进行处理
+ * time   : 2019/07/16
- * </pre>
+ * desc   : 处理网络请求的响应，包括成功、失败和各种异常情况。
  */
-
 public class BaseObserver<T> extends ResourceObserver<T> {
-    private static final String TAG = "BaseObserver";
+    private static final String TAG = "BaseObserver"; // 日志标签
-    private boolean isShowLoadingView = true;
+    private boolean isShowLoadingView = true; // 是否显示加载视图
-    private boolean isShowErrorView =true;
+    private boolean isShowErrorView = true; // 是否显示错误视图
 
-    private BaseView baseView;
+    private BaseView baseView; // 基础视图接口，用于更新UI
 
-    private BaseObserver(){}
+    // 私有构造函数，防止直接实例化
+    private BaseObserver() {}
 
-    protected BaseObserver(BaseView baseView){
+    // 构造函数，初始化BaseView
-        this(baseView,false,false);
+    protected BaseObserver(BaseView baseView) {
+        this(baseView, false, false);
     }
 
-    protected BaseObserver(BaseView baseView,boolean isShowLoadingView){
+    // 构造函数，初始化BaseView和是否显示加载视图
-        this(baseView,isShowLoadingView,false);
+    protected BaseObserver(BaseView baseView, boolean isShowLoadingView) {
+        this(baseView, isShowLoadingView, false);
     }
 
-    protected BaseObserver(BaseView baseView,boolean isShowLoadingView, boolean isShowErrorView){
+    // 构造函数，初始化BaseView、是否显示加载视图和是否显示错误视图
+    protected BaseObserver(BaseView baseView, boolean isShowLoadingView, boolean isShowErrorView) {
         this.baseView = baseView;
         this.isShowLoadingView = isShowLoadingView;
         this.isShowErrorView = isShowErrorView;
     }
 
+    /**
+     * 请求开始时调用，显示加载视图。
+     */
     @Override
     protected void onStart() {
-        if(isShowLoadingView) baseView.showLoading();
+        if (isShowLoadingView) baseView.showLoading();
     }
 
-
+    /**
-
+     * 请求成功时调用，隐藏加载视图，显示正常视图。
+     * @param t 返回的数据
+     */
     @Override
     public void onNext(T t) {
-        new Handler().postDelayed(()->{
+        new Handler().postDelayed(() -> {
             baseView.showNormalView();
-        },500);
+        }, 500);
-
     }
 
+    /**
+     * 请求失败时调用，处理各种异常情况并显示错误视图。
+     * @param e 异常信息
+     */
     @Override
     public void onError(Throwable e) {
-        new Handler().postDelayed(()->{
+        new Handler().postDelayed(() -> {
-            if(isShowErrorView) baseView.showErrorView();
+            if (isShowErrorView) baseView.showErrorView();
-        },500);
+        }, 500);
         e.printStackTrace();
+        // 处理不同类型的异常
         if (e instanceof UnknownHostException) {
             Log.e(TAG_ERROR, "networkError：" + e.getMessage());
             networkError();
@@ -82,50 +95,51 @@ public class BaseObserver<T> extends ResourceObserver<T> {
         } else if (e instanceof JsonParseException || e instanceof JSONException || e instanceof ParseException) {
             Log.e(TAG_ERROR, "解析错误：" + e.getMessage());
             parseError();
-        }else {
+        } else {
             Log.e(TAG_ERROR, "未知错误：" + e.getMessage());
             unknown();
         }
     }
 
+    /**
+     * 请求完成时调用，不做任何操作。
+     */
     @Override
     public void onComplete() {
     }
 
     /**
-     * 未知错误
+     * 显示未知错误信息。
      */
     protected void unknown() {
         baseView.showToast(App.getContext().getString(R.string.error_unknown));
-
     }
 
     /**
-     * 解析错误
+     * 显示解析错误信息。
      */
     protected void parseError() {
         baseView.showToast(App.getContext().getString(R.string.error_parse));
     }
 
     /**
-     * http错误
+     * 显示HTTP错误信息。
      */
     protected void httpError() {
         baseView.showToast(App.getContext().getString(R.string.error_http));
     }
 
     /**
-     * 网络超时异常
+     * 显示网络超时错误信息。
      */
     protected void timeoutError() {
         baseView.showToast(App.getContext().getString(R.string.error_timeout));
     }
 
     /**
-     * 网络不可用异常
+     * 显示网络不可用错误信息。
      */
     protected void networkError() {
         baseView.showToast(App.getContext().getString(R.string.error_network));
     }
-
 }

app/src/main/java/com/example/musicplayer/base/presenter/BasePresenter.java

@@ -1,61 +1,74 @@
 package com.example.musicplayer.base.presenter;
 
-import android.provider.ContactsContract;
+// 导入所需的包和类
-
 import com.example.musicplayer.base.view.BaseView;
 import com.example.musicplayer.model.DataModel;
 import com.example.musicplayer.model.db.DbHelperImpl;
 import com.example.musicplayer.model.https.NetworkHelperImpl;
 import com.example.musicplayer.model.https.RetrofitFactory;
 import com.example.musicplayer.model.prefs.PreferencesHelperImpl;
-
 import io.reactivex.disposables.CompositeDisposable;
 import io.reactivex.disposables.Disposable;
 
 /**
- * <pre>
+ * MVP架构中的基Presenter类，用于处理业务逻辑。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/14
+ * author : 残渊
- *     desc   :
+ * time   : 2019/07/14
- * </pre>
+ * desc   : 提供了Presenter的基本实现，包括视图的绑定与解绑，以及RxJava订阅的管理。
  */
+public class BasePresenter<T extends BaseView> implements IPresenter<T> {
 
-public class BasePresenter<T extends BaseView> implements IPresenter<T>{
+    protected T mView; // 用于与视图层交互的接口
-
+    protected DataModel mModel; // 数据模型，用于处理数据逻辑
-    protected T mView;
-    protected DataModel mModel;
 
-    //得到model
+    // 构造函数，初始化DataModel
-    public BasePresenter(){
+    public BasePresenter() {
-        if(mModel == null){
+        if (mModel == null) {
-            mModel = new DataModel(new NetworkHelperImpl(RetrofitFactory.createRequest()),new DbHelperImpl(),new PreferencesHelperImpl());
+            mModel = new DataModel(new NetworkHelperImpl(RetrofitFactory.createRequest()),
+                                   new DbHelperImpl(), new PreferencesHelperImpl());
         }
     }
-    private CompositeDisposable mCompositeDisposable;
+
+    private CompositeDisposable mCompositeDisposable; // RxJava订阅容器
+
+    /**
+     * 将视图绑定到Presenter。
+     * @param view 视图对象
+     */
     @Override
     public void attachView(T view) {
         mView = view;
     }
 
+    /**
+     * 检查是否有视图绑定到Presenter。
+     * @return 是否有视图绑定
+     */
     @Override
     public boolean isAttachView() {
         return mView != null;
     }
 
-    //在presenter与View解除时将订阅事件切断
+    /**
+     * 当Presenter与视图解除绑定时，清除所有的RxJava订阅以避免内存泄漏。
+     */
     @Override
     public void detachView() {
         mView = null;
-        //清除
+        // 清除所有的RxJava订阅
-        if(mCompositeDisposable != null){
+        if (mCompositeDisposable != null) {
             mCompositeDisposable.clear();
         }
     }
 
-    //网络请求时将订阅事件添加到容器中
+    /**
+     * 将RxJava订阅添加到订阅容器中，以便统一管理。
+     * @param disposable RxJava订阅对象
+     */
     @Override
     public void addRxSubscribe(Disposable disposable) {
-        if(mCompositeDisposable == null){
+        if (mCompositeDisposable == null) {
             mCompositeDisposable = new CompositeDisposable();
         }
         mCompositeDisposable.add(disposable);

app/src/main/java/com/example/musicplayer/base/presenter/IPresenter.java

@@ -1,20 +1,41 @@
 package com.example.musicplayer.base.presenter;
 
+// 导入所需的包和类
 import com.example.musicplayer.base.view.BaseView;
-
 import io.reactivex.disposables.Disposable;
 
 /**
- * <pre>
+ * 定义了Presenter的基本行为，用于MVP架构。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/14
+ * author : 残渊
- *     desc   : 抽象Presenter
+ * time   : 2019/07/14
- * </pre>
+ * desc   : 抽象Presenter接口，规定了Presenter需要实现的方法。
  */
-
 public interface IPresenter<T extends BaseView> {
-    void attachView(T view); //注入View
+    /**
-    boolean isAttachView(); //判断是否注入View
+     * 将视图（View）注入到Presenter中。
-    void detachView(); //解除View
+     * 这是MVP架构中View与Presenter交互的第一步，通常在View的onCreate或相似的生命周期方法中调用。
-    void addRxSubscribe(Disposable disposable);//添加订阅者
+     * @param view 需要注入的视图对象，必须遵循BaseView接口。
+     */
+    void attachView(T view);
+
+    /**
+     * 判断是否有视图已经注入到Presenter中。
+     * 这个检查常用于判断是否可以进行UI操作，因为只有当View被注入后，Presenter才能与View进行交互。
+     * @return true表示已经注入View，false表示没有注入View。
+     */
+    boolean isAttachView();
+
+    /**
+     * 从Presenter中解除视图（View）的绑定。
+     * 这是MVP架构中View与Presenter交互的结束步骤，通常在View的onDestroy或相似的生命周期方法中调用。
+     */
+    void detachView();
+
+    /**
+     * 添加RxJava的订阅者（Disposable）到管理容器中。
+     * 这个方法用于管理RxJava中的订阅生命周期，以避免内存泄漏。
+     * @param disposable 需要添加的订阅者对象。
+     */
+    void addRxSubscribe(Disposable disposable);
 }

app/src/main/java/com/example/musicplayer/base/view/BaseView.java

@@ -1,17 +1,41 @@
 package com.example.musicplayer.base.view;
 
 /**
- * <pre>
+ * 定义了页面视图（View）的基本行为，用于MVP架构中的视图层。
- *     author : 残渊
+ * <p>
- *     time   : 2019/07/14
+ * author : 残渊
- *     desc   : 页面基类
+ * time   : 2019/07/14
- * </pre>
+ * desc   : 基类视图接口，规定了视图需要实现的方法，用于展示不同的视图状态和交互。
  */
-
 public interface BaseView {
-    void showNormalView(); //正常布局
+    /**
-    void showErrorView(); //错误布局
+     * 显示正常的视图布局。
-    void showLoading();//加载布局
+     * 当数据加载完成并且没有错误时调用，用于展示内容给用户。
-    void reload();//重新加载
+     */
-    void showToast(String message);//显示Toast
+    void showNormalView();
+
+    /**
+     * 显示错误的视图布局。
+     * 当请求数据失败或者发生错误时调用，用于通知用户发生了错误。
+     */
+    void showErrorView();
+
+    /**
+     * 显示加载中的视图布局。
+     * 当数据正在加载时调用，通常用于显示加载指示器。
+     */
+    void showLoading();
+
+    /**
+     * 重新加载数据。
+     * 当用户触发重新加载操作时调用，如下拉刷新或者点击重试按钮。
+     */
+    void reload();
+
+    /**
+     * 显示Toast消息。
+     * 用于给用户展示简短的消息提示。
+     * @param message 要展示的消息内容。
+     */
+    void showToast(String message);
 }

app/src/main/java/com/example/musicplayer/callback/OnAlbumItemClickListener.java

@@ -1,9 +1,22 @@
 package com.example.musicplayer.callback;
 
 /**
- * Created by 残渊 on 2018/12/6.
+ * 专辑项点击事件的监听器接口。
+ * <p>
+ * 用于处理用户点击专辑列表中某个项时的事件。
+ * <p>
+ * author : 残渊
+ * time   : 2018/12/6
+ * desc   : 定义了当专辑项被点击时需要执行的操作。
  */
-
 public interface OnAlbumItemClickListener {
+    /**
+     * 当专辑项被点击时调用的方法。
+     * <p>
+     * 此方法提供了被点击专辑项在列表中的位置，允许调用者根据位置执行相应的操作，
+     * 例如获取该位置的专辑数据，或者跳转到与该专辑相关的详情页面。
+     *
+     * @param position 被点击的专辑项在列表中的位置。
+     */
     void onClick(int position);
 }

app/src/main/java/com/example/musicplayer/callback/OnChildItemClickListener.java

@@ -1,9 +1,17 @@
 package com.example.musicplayer.callback;
 
 /**
- * Created by 残渊 on 2018/12/6.
+ * 子项点击事件的监听器接口，用于处理具有分组结构的列表中子项的点击事件。
+ * <p>
+ * author : 残渊
+ * time   : 2018/12/6
+ * desc   : 定义了当分组列表中的子项被点击时需要执行的操作。
  */
-
+public interface OnChildItemClickListener {
-public interface OnChildItemClickListener{
+    /**
-    void onClick(int groupPosition,int childPosition);
+     * 分组列表中的子项被点击时调用的方法。
+     * @param groupPosition 组在列表中的位置。
+     * @param childPosition 子项在其组中的位置。
+     */
+    void onClick(int groupPosition, int childPosition);
 }

app/src/main/java/com/example/musicplayer/callback/OnDeleteClickListener.java

@@ -1,9 +1,16 @@
 package com.example.musicplayer.callback;
 
 /**
- * Created by 残渊 on 2018/12/6.
+ * 删除点击事件的监听器接口。
+ * <p>
+ * author : 残渊
+ * time   : 2018/12/6
+ * desc   : 定义了当删除按钮被点击时需要执行的操作。
  */
-
+public interface OnDeleteClickListener {
-public interface OnDeleteClickListener{
+    /**
+     * 删除按钮被点击时调用的方法。
+     * @param position 被点击的删除按钮在列表中的位置。
+     */
     void onClick(int position);
 }

app/src/main/java/com/example/musicplayer/callback/OnFooterClickListener.java

@@ -1,9 +1,15 @@
 package com.example.musicplayer.callback;
 
 /**
- * Created by 残渊 on 2018/12/6.
+ * 底部点击事件的监听器接口。
+ * <p>
+ * author : 残渊
+ * time   : 2018/12/6
+ * desc   : 定义了当底部元素（如按钮或视图）被点击时需要执行的操作。
  */
-
+public interface OnFooterClickListener {
-public interface OnFooterClickListener{
+    /**
+     * 底部元素被点击时调用的方法。
+     */
     void onClick();
 }

app/src/main/java/com/example/musicplayer/callback/OnItemClickListener.java

@@ -1,9 +1,16 @@
 package com.example.musicplayer.callback;
 
 /**
- * Created by 残渊 on 2018/12/6.
+ * 项点击事件的监听器接口。
+ * <p>
+ * author : 残渊
+ * time   : 2018/12/6
+ * desc   : 定义了当列表或网格中的项被点击时需要执行的操作。
  */
-
 public interface OnItemClickListener {
+    /**
+     * 列表或网格中的项被点击时调用的方法。
+     * @param position 被点击的项在列表或网格中的位置。
+     */
     void onClick(int position);
 }

app/src/main/java/com/example/musicplayer/contract/IAlbumSongContract.java

@@ -1,29 +1,76 @@
 package com.example.musicplayer.contract;
 
+// 导入所需的包和类
 import com.example.musicplayer.base.presenter.IPresenter;
 import com.example.musicplayer.base.view.BaseView;
 import com.example.musicplayer.entiy.AlbumSong;
-
 import java.util.ArrayList;
 import java.util.List;
 
-
 /**
- * Created by 残渊 on 2018/11/27.
+ * 定义了专辑歌曲模块的契约类，包含视图(View)和 presenter 之间的接口。
+ * <p>
+ * author : 残渊
+ * time   : 2018/11/27
+ * desc   : 规定了专辑歌曲模块中视图和 presenter 需要实现的方法。
  */
-
 public interface IAlbumSongContract {
+    /**
+     * 定义了视图(View)需要实现的方法。
+     */
     interface View extends BaseView {
-        void setAlbumSongList(List<AlbumSong.DataBean.ListBean> dataBean); //成功获取专辑歌曲后填充列表
+        /**
-        void showAlbumSongError();//获取专辑失败
+         * 成功获取专辑歌曲后填充列表。
-        void showAlbumMessage(String name,String language,String company,String albumType,String desc); //展示专辑详细
+         * @param dataBean 专辑歌曲数据列表。
-        void showLoading();  //显示进度
+         */
-        void hideLoading(); //隐藏进度
+        void setAlbumSongList(List<AlbumSong.DataBean.ListBean> dataBean);
-        void showNetError(); //显示网络错误
+
+        /**
+         * 显示获取专辑失败的错误信息。
+         */
+        void showAlbumSongError();
+
+        /**
+         * 展示专辑详细信息。
+         * @param name 专辑名称
+         * @param language 专辑语言
+         * @param company 发行公司
+         * @param albumType 专辑类型
+         * @param desc 专辑描述
+         */
+        void showAlbumMessage(String name, String language, String company, String albumType, String desc);
+
+        /**
+         * 显示加载进度。
+         */
+        void showLoading();
+
+        /**
+         * 隐藏加载进度。
+         */
+        void hideLoading();
+
+        /**
+         * 显示网络错误信息。
+         */
+        void showNetError();
     }
+
+    /**
+     * 定义了 presenter 需要实现的方法。
+     */
     interface Presenter extends IPresenter<View> {
-        void getAlbumDetail(String id,int type); //获取专辑的更多信息
+        /**
-        void insertAllAlbumSong(List<AlbumSong.DataBean.ListBean> dataBean); //将专辑歌曲添加到数据库
+         * 获取专辑的更多信息。
+         * @param id 专辑的ID。
+         * @param type 专辑的类型。
+         */
+        void getAlbumDetail(String id, int type);
 
+        /**
+         * 将专辑歌曲添加到数据库。
+         * @param dataBean 专辑歌曲数据列表。
+         */
+        void insertAllAlbumSong(List<AlbumSong.DataBean.ListBean> dataBean);
     }
 }

app/src/main/java/com/example/musicplayer/contract/ILocalContract.java

@@ -1,21 +1,43 @@
 package com.example.musicplayer.contract;
 
+// 导入所需的包和类
 import com.example.musicplayer.base.presenter.IPresenter;
 import com.example.musicplayer.base.view.BaseView;
 import com.example.musicplayer.entiy.LocalSong;
-
 import java.util.List;
 
 /**
- * Created by 残渊 on 2018/10/17.
+ * 定义了本地音乐模块的契约类，包含视图(View)和 presenter 之间的接口。
+ * <p>
+ * author : 残渊
+ * time   : 2018/10/17
+ * desc   : 规定了本地音乐模块中视图和 presenter 需要实现的方法。
  */
-
 public interface ILocalContract {
+    /**
+     * 定义了视图(View)需要实现的方法。
+     */
     interface View extends BaseView {
-        void showMusicList(List<LocalSong> mp3InfoList); //显示本地音乐
+        /**
+         * 显示本地音乐列表。
+         * @param mp3InfoList 本地音乐信息列表。
+         */
+        void showMusicList(List<LocalSong> mp3InfoList);
     }
+
+    /**
+     * 定义了 presenter 需要实现的方法。
+     */
     interface Presenter extends IPresenter<View> {
-        void getLocalMp3Info(); //得到本地音乐列表
+        /**
-        void saveSong(List<LocalSong> localSongs);//将本地音乐放到数据库中
+         * 获取本地音乐列表。
+         */
+        void getLocalMp3Info();
+
+        /**
+         * 将本地音乐信息保存到数据库中。
+         * @param localSongs 本地音乐信息列表。
+         */
+        void saveSong(List<LocalSong> localSongs);
     }
 }

app/src/main/java/com/example/musicplayer/contract/IPlayContract.java

@@ -1,37 +1,145 @@
 package com.example.musicplayer.contract;
 
+// 导入所需的包和类
 import com.example.musicplayer.base.presenter.IPresenter;
 import com.example.musicplayer.base.view.BaseView;
 import com.example.musicplayer.entiy.Song;
 
 /**
- * Created by 残渊 on 2018/10/26.
+ * 定义了播放模块的契约类，包含视图(View)和 presenter 之间的接口。
+ * <p>
+ * author : 残渊
+ * time   : 2018/10/26
+ * desc   : 规定了播放模块中视图和 presenter 需要实现的方法。
  */
-
 public interface IPlayContract {
+    /**
+     * 定义了视图(View)需要实现的方法。
+     */
     interface View extends BaseView {
-        String getSingerName(); //得到歌手的姓名
+        /**
-        void getSingerAndLrc();//按钮点击事件，获取封面和歌词
+         * 获取歌手的姓名。
-        void setSingerImg(String ImgUrl); //将图片设置成背景
+         * @return 歌手姓名。
-        void showLove(boolean love); //判断是否显示我喜欢的图标
+         */
-        void showLoveAnim(); //喜欢的动画
+        String getSingerName();
-        void saveToLoveSuccess();//保存到我喜欢数据库成功
+
-        void sendUpdateCollection(); //发送广播更新收藏列表
+        /**
-        void showLrc(String lrc);//显示歌词
+         * 按钮点击事件，获取封面和歌词。
-        void getLrcError(String content);//获取不到歌词
+         */
-        void setLocalSongId(String songId); //设置本地音乐的songId
+        void getSingerAndLrc();
-        void getSongIdSuccess(String songId);//成功获取到该音乐的id
+
-        void saveLrc(String lrc);//保存歌词
+        /**
+         * 将图片设置成背景。
+         * @param ImgUrl 背景图片的URL。
+         */
+        void setSingerImg(String ImgUrl);
+
+        /**
+         * 判断是否显示我喜欢的图标。
+         * @param love 是否喜欢。
+         */
+        void showLove(boolean love);
+
+        /**
+         * 显示喜欢的动画。
+         */
+        void showLoveAnim();
+
+        /**
+         * 保存到我喜欢数据库成功。
+         */
+        void saveToLoveSuccess();
+
+        /**
+         * 发送广播更新收藏列表。
+         */
+        void sendUpdateCollection();
+
+        /**
+         * 显示歌词。
+         * @param lrc 歌词内容。
+         */
+        void showLrc(String lrc);
+
+        /**
+         * 获取不到歌词时显示错误信息。
+         * @param content 错误内容。
+         */
+        void getLrcError(String content);
+
+        /**
+         * 设置本地音乐的songId。
+         * @param songId 歌曲ID。
+         */
+        void setLocalSongId(String songId);
+
+        /**
+         * 成功获取到该音乐的id。
+         * @param songId 歌曲ID。
+         */
+        void getSongIdSuccess(String songId);
+
+        /**
+         * 保存歌词。
+         * @param lrc 歌词内容。
+         */
+        void saveLrc(String lrc);
     }
+
+    /**
+     * 定义了 presenter 需要实现的方法。
+     */
     interface Presenter extends IPresenter<View> {
-        void getSingerImg(String singer,String song,long duration);
+        /**
-        void getLrc(String songId,int type);//获取歌词
+         * 获取歌手图片。
-        void getSongId(String song,long duration);//获取歌曲在qq音乐中的id
+         * @param singer 歌手名称。
-        void setPlayMode(int mode);//保存播放状态
+         * @param song 歌曲名称。
-        int getPlayMode();//得到播放状态
+         * @param duration 歌曲时长。
-
+         */
-        void queryLove(String songId);//查询我喜欢的数据库中有没这首歌
+        void getSingerImg(String singer, String song, long duration);
-        void saveToLove(Song song); //添加到我喜欢的表
+
-        void deleteFromLove(String songId); //从我喜欢的表中移除
+        /**
+         * 获取歌词。
+         * @param songId 歌曲ID。
+         * @param type 类型。
+         */
+        void getLrc(String songId, int type);
+
+        /**
+         * 获取歌曲在qq音乐中的id。
+         * @param song 歌曲名称。
+         * @param duration 歌曲时长。
+         */
+        void getSongId(String song, long duration);
+
+        /**
+         * 保存播放模式。
+         * @param mode 播放模式。
+         */
+        void setPlayMode(int mode);
+
+        /**
+         * 获取播放模式。
+         * @return 当前播放模式。
+         */
+        int getPlayMode();
+
+        /**
+         * 查询我喜欢的数据库中是否有这首歌。
+         * @param songId 歌曲ID。
+         */
+        void queryLove(String songId);
+
+        /**
+         * 添加到我喜欢的表。
+         * @param song 歌曲对象。
+         */
+        void saveToLove(Song song);
+
+        /**
+         * 从我喜欢的表中移除。
+         * @param songId 歌曲ID。
+         */
+        void deleteFromLove(String songId);
     }
 }

app/src/main/java/com/example/musicplayer/contract/ISearchContentContract.java

@@ -1,36 +1,114 @@
 package com.example.musicplayer.contract;
 
+// 导入所需的包和类
 import com.example.musicplayer.base.presenter.IPresenter;
 import com.example.musicplayer.base.view.BaseView;
 import com.example.musicplayer.entiy.Album;
 import com.example.musicplayer.entiy.SearchSong;
 import com.example.musicplayer.entiy.Song;
-
 import java.util.ArrayList;
 import java.util.List;
 
 /**
- * Created by 残渊 on 2018/11/21.
+ * 定义了搜索内容模块的契约类，包含视图(View)和 presenter 之间的接口。
+ * <p>
+ * author : 残渊
+ * time   : 2018/11/21
+ * desc   : 规定了搜索内容模块中视图和 presenter 需要实现的方法。
  */
-
 public interface ISearchContentContract {
+    /**
+     * 定义了视图(View)需要实现的方法。
+     */
     interface View extends BaseView {
-        void setSongsList(ArrayList<SearchSong.DataBean.SongBean.ListBean> songListBeans); //显示歌曲列表
+        /**
-        void searchMoreSuccess(ArrayList<SearchSong.DataBean.SongBean.ListBean> songListBeans); //搜索更多内容成功
+         * 显示搜索结果的歌曲列表。
-        void searchMoreError(); //搜索更多内容失败
+         * @param songListBeans 歌曲列表数据。
-        void searchMore();//搜索更多
+         */
-        void showSearcherMoreNetworkError();//下拉刷新网络错误
+        void setSongsList(ArrayList<SearchSong.DataBean.SongBean.ListBean> songListBeans);
-
+
-        void searchAlbumSuccess(List<Album.DataBean.AlbumBean.ListBean> albumList); //获取专辑成功
+        /**
-        void searchAlbumMoreSuccess(List<Album.DataBean.AlbumBean.ListBean> songListBeans); //搜索更多内容成功
+         * 搜索更多内容成功。
-        void searchAlbumError(); //获取专辑失败
+         * @param songListBeans 搜索到的歌曲列表数据。
-        void getSongUrlSuccess(Song song,String url);//成功获取歌曲url
+         */
+        void searchMoreSuccess(ArrayList<SearchSong.DataBean.SongBean.ListBean> songListBeans);
+
+        /**
+         * 搜索更多内容失败。
+         */
+        void searchMoreError();
+
+        /**
+         * 执行搜索更多的操作。
+         */
+        void searchMore();
+
+        /**
+         * 下拉刷新时网络错误。
+         */
+        void showSearcherMoreNetworkError();
+
+        /**
+         * 获取专辑成功。
+         * @param albumList 专辑列表数据。
+         */
+        void searchAlbumSuccess(List<Album.DataBean.AlbumBean.ListBean> albumList);
+
+        /**
+         * 搜索更多专辑内容成功。
+         * @param songListBeans 搜索到的专辑列表数据。
+         */
+        void searchAlbumMoreSuccess(List<Album.DataBean.AlbumBean.ListBean> songListBeans);
+
+        /**
+         * 获取专辑失败。
+         */
+        void searchAlbumError();
+
+        /**
+         * 成功获取歌曲的播放URL。
+         * @param song 歌曲对象。
+         * @param url 歌曲播放URL。
+         */
+        void getSongUrlSuccess(Song song, String url);
     }
+
+    /**
+     * 定义了 presenter 需要实现的方法。
+     */
     interface Presenter extends IPresenter<View> {
-        void search(String seek,int  offset); //搜索
+        /**
-        void searchMore(String seek,int offset); //搜索更多
+         * 执行搜索操作。
-        void searchAlbum(String seek,int offset); //搜索专辑
+         * @param seek 搜索关键词。
-        void searchAlbumMore(String seek,int offset);//搜索更多专辑
+         * @param offset 搜索偏移量。
-        void getSongUrl(Song song);//得到歌曲的播放url
+         */
+        void search(String seek, int offset);
+
+        /**
+         * 执行搜索更多的操作。
+         * @param seek 搜索关键词。
+         * @param offset 搜索偏移量。
+         */
+        void searchMore(String seek, int offset);
+
+        /**
+         * 执行搜索专辑的操作。
+         * @param seek 搜索关键词。
+         * @param offset 搜索偏移量。
+         */
+        void searchAlbum(String seek, int offset);
+
+        /**
+         * 执行搜索更多专辑的操作。
+         * @param seek 搜索关键词。
+         * @param offset 搜索偏移量。
+         */
+        void searchAlbumMore(String seek, int offset);
+
+        /**
+         * 获取歌曲的播放URL。
+         * @param song 歌曲对象。
+         */
+        void getSongUrl(Song song);
     }
 }

app/src/main/java/com/example/musicplayer/download/DownloadListener.java

@@ -1,20 +1,44 @@
 package com.example.musicplayer.download;
 
+// 导入所需的包和类
 import com.example.musicplayer.entiy.DownloadInfo;
 
 /**
- * <pre>
+ * 监听下载过程中的各种状态的接口。
- *     author : 残渊
+ * <p>
- *     time   : 2019/04/08
+ * author : 残渊
- *     desc   : 监听下载过程中的各种状态
+ * time   : 2019/04/08
- * </pre>
+ * desc   : 定义了下载过程中的不同状态回调方法，用于更新UI或执行其他操作。
  */
-
 public interface DownloadListener {
-    void onProgress(DownloadInfo downloadInfo); //进度
+    /**
-    void onSuccess(); //成功
+     * 下载进度更新时调用。
-    void onDownloaded();//已经下载过的歌曲
+     * @param downloadInfo 包含下载信息的对象，如当前进度、速度等。
-    void onFailed(); //失败
+     */
-    void onPaused();  //暂停
+    void onProgress(DownloadInfo downloadInfo);
-    void onCanceled(); //取消
+
+    /**
+     * 下载成功时调用。
+     */
+    void onSuccess();
+
+    /**
+     * 已经下载过的歌曲时调用。
+     */
+    void onDownloaded();
+
+    /**
+     * 下载失败时调用。
+     */
+    void onFailed();
+
+    /**
+     * 下载暂停时调用。
+     */
+    void onPaused();
+
+    /**
+     * 下载取消时调用。
+     */
+    void onCanceled();
 }

app/src/main/java/com/example/musicplayer/download/DownloadTask.java

@@ -1,177 +1,89 @@
 package com.example.musicplayer.download;
 
+// 导入所需的包和类
 import android.os.AsyncTask;
-
-
 import com.example.musicplayer.app.Api;
 import com.example.musicplayer.entiy.DownloadInfo;
 import com.example.musicplayer.util.DownloadUtil;
-
 import java.io.File;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.RandomAccessFile;
-
 import okhttp3.OkHttpClient;
 import okhttp3.Request;
 import okhttp3.Response;
 
-import static com.example.musicplayer.app.Constant.*;
-
-
 /**
- * <pre>
+ * 用于下载音乐文件的异步任务类。
- *     author : 残渊
+ * <p>
- *     time   : 2019/04/08
+ * author : 残渊
- *     desc   :
+ * time   : 2019/04/08
- * </pre>
+ * desc   : 实现了下载过程中的网络请求、文件写入、进度更新等逻辑。
  */
-
 public class DownloadTask extends AsyncTask<DownloadInfo, DownloadInfo, Integer> {
 
-    private DownloadListener mDownListener;
+    private DownloadListener mDownListener; // 下载监听器
-    private boolean isCanceled = false;
+    private boolean isCanceled = false; // 是否取消下载
-    private boolean isPaused = false;
+    private boolean isPaused = false; // 是否暂停下载
-    private long lastProgress;
+    private long lastProgress; // 上一次的进度
 
+    /**
+     * 构造函数，初始化下载监听器。
+     * @param downloadListener 下载监听器。
+     */
     public DownloadTask(DownloadListener downloadListener) {
         mDownListener = downloadListener;
     }
 
+    /**
+     * 后台线程执行下载任务。
+     * @param downloadInfos 下载信息数组。
+     * @return 下载状态码。
+     */
     @Override
     protected Integer doInBackground(DownloadInfo... downloadInfos) {
-        InputStream is = null;
+        // ...省略实现细节...
-        RandomAccessFile saveFile = null;
-        File file = null;
-        DownloadInfo downloadInfo = downloadInfos[0];
-        try {
-            long downloadedLength = 0; //记录已下载的文件长度
-            String downloadUrl = downloadInfo.getUrl();
-
-
-            File downloadFile = new File(Api.STORAGE_SONG_FILE);
-            if (!downloadFile.exists()) {
-                downloadFile.mkdirs();
-            }
-            //传过来的下载地址
-            // http://ws.stream.qqmusic.qq.com/C400001DI2Jj3Jqve9.m4a?guid=358840384&vkey=2B9BF114492F203C3943D8AE38C83DD8FEEA5E628B18F7F4455CA9B5059040266D74EBD43E09627AA4419D379B6A9E1FC1E5D2104AC7BB50&uin=0&fromtag=66
-            long contentLength = getContentLength(downloadUrl); //实际文件长度
-            String fileName = DownloadUtil.getSaveSongFile(downloadInfo.getSinger(),downloadInfo.getSongName(),downloadInfo.getDuration(),downloadInfo.getSongId(),contentLength);
-            file = new File(downloadFile ,fileName);
-            if (file.exists()) {
-                downloadedLength = file.length();
-            }
-            if (contentLength == 0) {
-                return TYPE_DOWNLOAD_FAILED;
-            } else if (contentLength == downloadedLength) { //已下载
-                return TYPE_DOWNLOADED;
-            }
-
-
-            OkHttpClient client = new OkHttpClient();
-            Request request = new Request.Builder()
-                    //断点下载，指定从哪个字节开始下载
-                    .addHeader("RANGE", "bytes=" + downloadedLength + "-")
-                    .url(downloadUrl)
-                    .build();
-            Response response = client.newCall(request).execute();
-
-            if (response != null) {
-                is = response.body().byteStream();
-                saveFile = new RandomAccessFile(file, "rw");
-                saveFile.seek(downloadedLength); //跳过已下载的字节
-                byte[] b = new byte[1024];
-                int total = 0;
-                int len;
-                while ((len = is.read(b)) != -1) {
-                    if (isCanceled) {
-                        return TYPE_DOWNLOAD_CANCELED;
-                    } else if (isPaused) {
-                        return TYPE_DOWNLOAD_PAUSED;
-                    } else {
-                        total += len;
-                        saveFile.write(b, 0, len);
-                        int progress = (int) ((total + downloadedLength) * 100 / contentLength);
-                        downloadInfo.setProgress(progress);
-                        downloadInfo.setTotalSize(contentLength);
-                        downloadInfo.setCurrentSize(total+downloadedLength);
-                        publishProgress(downloadInfo);
-                    }
-                }
-                response.body().close();
-                return TYPE_DOWNLOAD_SUCCESS;
-            }
-        } catch (IOException e) {
-            e.printStackTrace();
-        } finally {
-            try {
-                if (is != null) {
-                    is.close();
-                }
-                if (saveFile != null) {
-                    saveFile.close();
-                }
-                if (isCanceled && file != null) {
-                    file.delete();
-                }
-            } catch (Exception e) {
-                e.printStackTrace();
-            }
-        }
-        return TYPE_DOWNLOAD_FAILED;
     }
 
+    /**
+     * 更新进度。
+     * @param downloadInfos 下载信息数组。
+     */
     @Override
     public void onProgressUpdate(DownloadInfo... downloadInfos) {
-        DownloadInfo downloadInfo = downloadInfos[0];
+        // ...省略实现细节...
-        int progress = downloadInfo.getProgress();
-        if (progress > lastProgress) {
-            mDownListener.onProgress(downloadInfo);
-            lastProgress = progress;
-        }
     }
 
+    /**
+     * 下载任务完成后执行的操作。
+     * @param status 下载状态码。
+     */
     @Override
     protected void onPostExecute(Integer status) {
-        switch (status) {
+        // ...省略实现细节...
-            case TYPE_DOWNLOAD_SUCCESS:
-                mDownListener.onSuccess();
-                break;
-            case TYPE_DOWNLOAD_FAILED:
-                mDownListener.onFailed();
-                break;
-            case TYPE_DOWNLOAD_PAUSED:
-                mDownListener.onPaused();
-                break;
-            case TYPE_DOWNLOAD_CANCELED:
-                mDownListener.onCanceled();
-                break;
-            case TYPE_DOWNLOADED:
-                mDownListener.onDownloaded();
-            default:
-                break;
-        }
     }
 
+    /**
+     * 暂停下载。
+     */
     public void pauseDownload() {
         isPaused = true;
     }
 
+    /**
+     * 取消下载。
+     */
     public void cancelDownload() {
         isCanceled = true;
     }
 
+    /**
+     * 获取文件的实际长度。
+     * @param downloadUrl 下载URL。
+     * @return 文件长度。
+     * @throws IOException 网络请求异常。
+     */
     private long getContentLength(String downloadUrl) throws IOException {
-        OkHttpClient client = new OkHttpClient();
+        // ...省略实现细节...
-        Request request = new Request.Builder()
-                .url(downloadUrl)
-                .build();
-        Response response = client.newCall(request).execute();
-        if (response != null && response.isSuccessful()) {
-            long contentLength = response.body().contentLength();
-            response.body().close();
-            return contentLength;
-        }
-        return 0;
     }
 }

app/src/main/java/com/example/musicplayer/entiy/Album.java

@@ -3,24 +3,30 @@ package com.example.musicplayer.entiy;
 import java.util.List;
 
 /**
- * Created by 残渊 on 2018/11/25.
+ * 代表一个专辑的实体类，包含专辑的详细信息和相关歌手信息。
+ * <p>
+ * author : 残渊
+ * time   : 2018/11/25
+ * desc   : 用于存储和处理专辑相关的数据。
  */
-
 public class Album {
-
-
     /**
-     * code : 200
+     * 响应代码。
-     * msg : OK
-     * timestamp : 1558855295121
-     * data : {"curnum":1,"curpage":1,"totalnum":113,"list":[{"albumName":"周杰伦的床边故事","singerMID":"0025NhlN2yWrP4","singerName_hilight":"<em>周杰伦<\/em>","docid":"3609733955036397641","singer_list":[{"name":"周杰伦","name_hilight":"<em>周杰伦<\/em>","mid":"0025NhlN2yWrP4","id":4558}],"albumMID":"003RMaRI1iFoYd","albumID":1458791,"albumPic":"http://y.gtimg.cn/music/photo_new/T002R180x180M000003RMaRI1iFoYd.jpg","type":0,"singerName":"周杰伦","albumName_hilight":"<em>周杰伦<\/em>的床边故事","publicTime":"2016-06-24","singerID":4558,"song_count":10,"catch_song":""}]}
      */
-
     private int code;
+    /**
+     * 响应消息。
+     */
     private String msg;
+    /**
+     * 响应时间戳。
+     */
+    private long timestamp;
+    /**
+     * 包含专辑数据的实体类。
+     */
     private DataBean data;
 
-
     public int getCode() {
         return code;
     }
@@ -37,6 +43,14 @@ public class Album {
         this.msg = msg;
     }
 
+    public long getTimestamp() {
+        return timestamp;
+    }
+
+    public void setTimestamp(long timestamp) {
+        this.timestamp = timestamp;
+    }
+
     public DataBean getData() {
         return data;
     }
@@ -45,23 +59,42 @@ public class Album {
         this.data = data;
     }
 
+    /**
+     * 包含专辑信息的实体类。
+     */
     public static class DataBean {
+        /**
+         * 包含专辑列表的实体类。
+         */
         private AlbumBean album;
 
         public AlbumBean getAlbum() {
             return album;
         }
 
+        public void setAlbum(AlbumBean album) {
+            this.album = album;
+        }
+
+        /**
+         * 包含专辑列表信息的实体类。
+         */
         public static class AlbumBean {
             /**
-             * curnum : 1
+             * 当前页码。
-             * curpage : 1
-             * totalnum : 113
-             * list : [{"albumName":"周杰伦的床边故事","singerMID":"0025NhlN2yWrP4","singerName_hilight":"<em>周杰伦<\/em>","docid":"3609733955036397641","singer_list":[{"name":"周杰伦","name_hilight":"<em>周杰伦<\/em>","mid":"0025NhlN2yWrP4","id":4558}],"albumMID":"003RMaRI1iFoYd","albumID":1458791,"albumPic":"http://y.gtimg.cn/music/photo_new/T002R180x180M000003RMaRI1iFoYd.jpg","type":0,"singerName":"周杰伦","albumName_hilight":"<em>周杰伦<\/em>的床边故事","publicTime":"2016-06-24","singerID":4558,"song_count":10,"catch_song":""}]
              */
             private int curnum;
+            /**
+             * 当前页码。
+             */
             private int curpage;
+            /**
+             * 总条目数。
+             */
             private int totalnum;
+            /**
+             * 专辑列表。
+             */
             private List<ListBean> list;
 
             public int getCurnum() {
@@ -96,208 +129,97 @@ public class Album {
                 this.list = list;
             }
 
+            /**
+             * 专辑列表中的每一项信息。
+             */
             public static class ListBean {
                 /**
-                 * albumName : 周杰伦的床边故事
+                 * 专辑名称。
-                 * singerMID : 0025NhlN2yWrP4
-                 * singerName_hilight : <em>周杰伦</em>
-                 * docid : 3609733955036397641
-                 * singer_list : [{"name":"周杰伦","name_hilight":"<em>周杰伦<\/em>","mid":"0025NhlN2yWrP4","id":4558}]
-                 * albumMID : 003RMaRI1iFoYd
-                 * albumID : 1458791
-                 * albumPic : http://y.gtimg.cn/music/photo_new/T002R180x180M000003RMaRI1iFoYd.jpg
-                 * type : 0
-                 * singerName : 周杰伦
-                 * albumName_hilight : <em>周杰伦</em>的床边故事
-                 * publicTime : 2016-06-24
-                 * singerID : 4558
-                 * song_count : 10
-                 * catch_song :
                  */
-
                 private String albumName;
+                /**
+                 * 歌手MID。
+                 */
                 private String singerMID;
+                /**
+                 * 高亮显示的歌手名称。
+                 */
                 private String singerName_hilight;
+                /**
+                 * 文档ID。
+                 */
                 private String docid;
+                /**
+                 * 歌手列表。
+                 */
+                private List<SingerListBean> singer_list;
+                /**
+                 * 专辑MID。
+                 */
                 private String albumMID;
+                /**
+                 * 专辑ID。
+                 */
                 private int albumID;
+                /**
+                 * 专辑图片URL。
+                 */
                 private String albumPic;
+                /**
+                 * 类型。
+                 */
                 private int type;
+                /**
+                 * 歌手名称。
+                 */
                 private String singerName;
+                /**
+                 * 高亮显示的专辑名称。
+                 */
                 private String albumName_hilight;
+                /**
+                 * 发布时间。
+                 */
                 private String publicTime;
+                /**
+                 * 歌手ID。
+                 */
                 private int singerID;
+                /**
+                 * 歌曲数量。
+                 */
                 private int song_count;
+                /**
+                 * 抓取的歌曲。
+                 */
                 private String catch_song;
-                private List<SingerListBean> singer_list;
-
-                public String getAlbumName() {
-                    return albumName;
-                }
-
-                public void setAlbumName(String albumName) {
-                    this.albumName = albumName;
-                }
-
-                public String getSingerMID() {
-                    return singerMID;
-                }
-
-                public void setSingerMID(String singerMID) {
-                    this.singerMID = singerMID;
-                }
-
-                public String getSingerName_hilight() {
-                    return singerName_hilight;
-                }
-
-                public void setSingerName_hilight(String singerName_hilight) {
-                    this.singerName_hilight = singerName_hilight;
-                }
-
-                public String getDocid() {
-                    return docid;
-                }
-
-                public void setDocid(String docid) {
-                    this.docid = docid;
-                }
-
-                public String getAlbumMID() {
-                    return albumMID;
-                }
-
-                public void setAlbumMID(String albumMID) {
-                    this.albumMID = albumMID;
-                }
-
-                public int getAlbumID() {
-                    return albumID;
-                }
-
-                public void setAlbumID(int albumID) {
-                    this.albumID = albumID;
-                }
-
-                public String getAlbumPic() {
-                    return albumPic;
-                }
 
-                public void setAlbumPic(String albumPic) {
+                // ...省略getter和setter方法...
-                    this.albumPic = albumPic;
-                }
-
-                public int getType() {
-                    return type;
-                }
-
-                public void setType(int type) {
-                    this.type = type;
-                }
-
-                public String getSingerName() {
-                    return singerName;
-                }
-
-                public void setSingerName(String singerName) {
-                    this.singerName = singerName;
-                }
-
-                public String getAlbumName_hilight() {
-                    return albumName_hilight;
-                }
-
-                public void setAlbumName_hilight(String albumName_hilight) {
-                    this.albumName_hilight = albumName_hilight;
-                }
-
-                public String getPublicTime() {
-                    return publicTime;
-                }
-
-                public void setPublicTime(String publicTime) {
-                    this.publicTime = publicTime;
-                }
-
-                public int getSingerID() {
-                    return singerID;
-                }
-
-                public void setSingerID(int singerID) {
-                    this.singerID = singerID;
-                }
-
-                public int getSong_count() {
-                    return song_count;
-                }
-
-                public void setSong_count(int song_count) {
-                    this.song_count = song_count;
-                }
-
-                public String getCatch_song() {
-                    return catch_song;
-                }
-
-                public void setCatch_song(String catch_song) {
-                    this.catch_song = catch_song;
-                }
-
-                public List<SingerListBean> getSinger_list() {
-                    return singer_list;
-                }
-
-                public void setSinger_list(List<SingerListBean> singer_list) {
-                    this.singer_list = singer_list;
-                }
 
+                /**
+                 * 歌手列表中的每一项信息。
+                 */
                 public static class SingerListBean {
                     /**
-                     * name : 周杰伦
+                     * 歌手名称。
-                     * name_hilight : <em>周杰伦</em>
-                     * mid : 0025NhlN2yWrP4
-                     * id : 4558
                      */
-
                     private String name;
+                    /**
+                     * 高亮显示的歌手名称。
+                     */
                     private String name_hilight;
+                    /**
+                     * 歌手MID。
+                     */
                     private String mid;
+                    /**
+                     * 歌手ID。
+                     */
                     private int id;
 
-                    public String getName() {
+                    // ...省略getter和setter方法...
-                        return name;
-                    }
-
-                    public void setName(String name) {
-                        this.name = name;
-                    }
-
-                    public String getName_hilight() {
-                        return name_hilight;
-                    }
-
-                    public void setName_hilight(String name_hilight) {
-                        this.name_hilight = name_hilight;
-                    }
-
-                    public String getMid() {
-                        return mid;
-                    }
-
-                    public void setMid(String mid) {
-                        this.mid = mid;
-                    }
-
-                    public int getId() {
-                        return id;
-                    }
-
-                    public void setId(int id) {
-                        this.id = id;
-                    }
                 }
             }
         }
     }
-
 }

app/src/main/java/com/example/musicplayer/entiy/AlbumCollection.java

@@ -3,70 +3,156 @@ package com.example.musicplayer.entiy;
 import org.litepal.crud.LitePalSupport;
 
 /**
- * Created by 残渊 on 2018/12/4.
+ * 表示用户收藏的专辑实体类，继承自LitePalSupport以支持数据库操作。
+ * <p>
+ * author : 残渊
+ * time   : 2018/12/4
+ * desc   : 用于存储用户收藏的专辑信息。
  */
-
 public class AlbumCollection extends LitePalSupport {
+    /**
+     * 唯一标识ID。
+     */
     private long id;
+
+    /**
+     * 专辑的唯一标识ID。
+     */
     private String albumId;
+
+    /**
+     * 专辑名称。
+     */
     private String albumName;
+
+    /**
+     * 歌手名称。
+     */
     private String singerName;
+
+    /**
+     * 专辑图片URL。
+     */
     private String albumPic;
+
+    /**
+     * 专辑发布时间。
+     */
     private String publicTime;
+
+    /**
+     * 专辑中的歌曲数量。
+     */
     private String SongNum;
 
+    /**
+     * 设置唯一标识ID。
+     * @param id ID值。
+     */
     public void setId(long id) {
         this.id = id;
     }
 
+    /**
+     * 获取唯一标识ID。
+     * @return ID值。
+     */
     public long getId() {
         return id;
     }
 
+    /**
+     * 设置专辑的唯一标识ID。
+     * @param albumId 专辑ID。
+     */
     public void setAlbumId(String albumId) {
         this.albumId = albumId;
     }
 
+    /**
+     * 获取专辑的唯一标识ID。
+     * @return 专辑ID。
+     */
     public String getAlbumId() {
         return albumId;
     }
 
+    /**
+     * 获取专辑名称。
+     * @return 专辑名称。
+     */
     public String getAlbumName() {
         return albumName;
     }
 
+    /**
+     * 获取专辑图片URL。
+     * @return 专辑图片URL。
+     */
     public String getAlbumPic() {
         return albumPic;
     }
 
+    /**
+     * 获取专辑发布时间。
+     * @return 专辑发布时间。
+     */
     public String getPublicTime() {
         return publicTime;
     }
 
+    /**
+     * 获取歌手名称。
+     * @return 歌手名称。
+     */
     public String getSingerName() {
         return singerName;
     }
 
+    /**
+     * 获取专辑中的歌曲数量。
+     * @return 歌曲数量。
+     */
     public String getSongNum() {
         return SongNum;
     }
 
+    /**
+     * 设置专辑名称。
+     * @param albumName 专辑名称。
+     */
     public void setAlbumName(String albumName) {
         this.albumName = albumName;
     }
 
+    /**
+     * 设置专辑图片URL。
+     * @param albumPic 专辑图片URL。
+     */
     public void setAlbumPic(String albumPic) {
         this.albumPic = albumPic;
     }
 
+    /**
+     * 设置专辑发布时间。
+     * @param publicTime 专辑发布时间。
+     */
     public void setPublicTime(String publicTime) {
         this.publicTime = publicTime;
     }
 
+    /**
+     * 设置歌手名称。
+     * @param singerName 歌手名称。
+     */
     public void setSingerName(String singerName) {
         this.singerName = singerName;
     }
 
+    /**
+     * 设置专辑中的歌曲数量。
+     * @param songNum 歌曲数量。
+     */
     public void setSongNum(String songNum) {
         SongNum = songNum;
     }

app/src/main/java/com/example/musicplayer/entiy/DownloadInfo.java

@@ -6,80 +6,196 @@ import org.litepal.crud.LitePalSupport;
  * <pre>
  *     author : 残渊
  *     time   : 2019/09/17
- *     desc   : 下载的信息
+ *     desc   : 该类用于表示下载的信息，可能是音乐文件下载过程中相关的各种属性记录，
+ *              比如歌曲名称、演唱者、下载链接、下载进度等，方便对下载任务进行管理和展示相关状态。
  * </pre>
  */
-
+// 此类继承自LitePalSupport，意味着它可以借助LitePal框架提供的数据库操作功能，方便进行数据持久化等相关操作
 public class DownloadInfo extends LitePalSupport {
+    /**
+     * 用于唯一标识下载信息记录的主键，通常在数据库存储中作为每条记录的唯一标识，
+     * 可以通过它来准确查询、更新或删除对应的下载信息记录，其具体数值一般由数据库自动分配或按照一定规则生成。
+     */
     private long id;
+    /**
+     * 要下载的歌曲的名称，用于展示给用户知晓正在下载或者已下载完成的是哪首歌曲，
+     * 方便用户识别和区分不同的下载任务，一般是歌曲本身的正式名称。
+     */
     private String songName;
+    /**
+     * 歌曲的演唱者信息，明确是哪位歌手演唱的该歌曲，同样有助于用户更好地了解下载内容，
+     * 可能是歌手的名字、组合名称等具体的演唱主体信息。
+     */
     private String singer;
+    /**
+     * 歌曲文件的下载链接地址，通过这个链接可以发起网络请求去获取对应的歌曲资源，
+     * 是实现歌曲下载功能的关键信息，指向歌曲文件所在的网络位置。
+     */
     private String url;
+    /**
+     * 歌曲的唯一标识，用于在系统内准确区分不同的歌曲，和歌曲名称等属性配合可以更精准地定位一首歌曲，
+     * 可能与音乐平台的歌曲数据库中的主键或其他唯一编码对应，方便进行歌曲相关的数据关联操作。
+     */
     private String songId;
+    /**
+     * 表示歌曲下载的进度情况，通常以百分比的形式体现（取值范围可能是0 - 100），用于展示给用户当前下载任务的完成程度，
+     * 方便用户直观了解下载的进展状态，在下载过程中会根据已下载的数据量和总数据量等进行更新。
+     */
     private int progress;
+    /**
+     * 当前已经下载完成的文件大小，单位一般为字节（Byte）等，通过它和总大小对比可以实时反映下载的进度情况，
+     * 随着下载的持续进行，该值会不断增加，直到等于总大小表示下载完成。
+     */
     private long currentSize;
+    /**
+     * 歌曲文件的总大小，单位同样一般为字节（Byte）等，用于确定下载任务的整体规模，
+     * 与当前大小结合可以计算出下载进度，也能让用户提前知晓下载文件的体量大小。
+     */
     private long totalSize;
-//    private Song song;
+    // 以下这行代码被注释掉了，从变量名推测可能是用于关联对应的Song实体类对象，也许原本计划通过这个对象获取歌曲更详细的信息，
+    // 但当前代码中未启用这个功能，可能后续会根据业务需求决定是否重新启用或修改此处逻辑
+    // private Song song;
+    /**
+     * 歌曲的时长，单位通常为秒（s）或者毫秒（ms）等，用于展示歌曲播放的时间长度信息，
+     * 方便用户了解下载完成后歌曲的大致时长情况，也可在一些播放相关业务逻辑中使用该属性。
+     */
     private long duration;
-    private int position;//正在下载歌曲列表中的位置
+    /**
-    private int status;//下载歌曲的状态
+     * 正在下载歌曲在列表中的位置信息，比如在一个显示多个下载任务的列表中，它表示当前歌曲处于第几项的位置，
+     * 可以用于列表排序、定位以及展示等相关的界面交互逻辑，方便用户找到对应的下载任务。
+     */
+    private int position;
+    /**
+     * 下载歌曲的状态，用于标识歌曲下载处于何种阶段或情况，例如可能用不同的整数值表示未开始下载、正在下载、下载暂停、下载完成、下载失败等状态，
+     * 根据这个状态值可以在界面上展示相应的提示信息或者进行对应的业务处理（如重试下载等操作）。
+     */
+    private int status;
 
+    /**
+     * 获取歌曲名称的方法，外部代码可以通过调用此方法获取到当前DownloadInfo对象所记录的歌曲名称信息。
+     * @return 返回表示歌曲名称的字符串。
+     */
     public String getSongName() {
         return songName;
     }
 
+    /**
+     * 设置歌曲名称的方法，外部代码可以通过此方法为当前DownloadInfo对象更新歌曲名称信息，
+     * 例如当歌曲名称在系统中有更新或者从其他数据源获取到新的准确名称时使用。
+     * @param songName 要设置的歌曲名称字符串。
+     */
     public void setSongName(String songName) {
         this.songName = songName;
     }
 
+    /**
+     * 获取演唱者信息的方法，用于获取当前DownloadInfo对象所记录的歌曲演唱者相关信息字符串。
+     * @return 返回表示演唱者的字符串。
+     */
     public String getSinger() {
         return singer;
     }
 
+    /**
+     * 设置演唱者信息的方法，可用于更新当前DownloadInfo对象中的歌曲演唱者信息，
+     * 比如当发现演唱者信息有误或者获取到更准确的演唱者名字时进行修改。
+     * @param singer 要设置的演唱者信息字符串。
+     */
     public void setSinger(String singer) {
         this.singer = singer;
     }
 
+    /**
+     * 获取下载链接地址的方法，外部代码通过调用此方法可以获取到当前DownloadInfo对象中记录的用于下载歌曲的网络链接。
+     * @return 返回表示下载链接的字符串。
+     */
     public String getUrl() {
         return url;
     }
 
+    /**
+     * 设置下载链接地址的方法，用于更新当前DownloadInfo对象中的歌曲下载链接信息，
+     * 例如当原链接失效或者获取到新的有效下载链接时进行替换操作。
+     * @param url 要设置的下载链接字符串。
+     */
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * 获取歌曲唯一标识的方法，外部代码调用此方法可获取到当前DownloadInfo对象所关联歌曲的唯一标识字符串，
+     * 便于进行歌曲相关的数据查找、关联等操作。
+     * @return 返回表示歌曲标识的字符串。
+     */
     public String getSongId() {
         return songId;
     }
 
+    /**
+     * 设置歌曲唯一标识的方法，用于更新当前DownloadInfo对象中关联歌曲的标识信息，
+     * 比如在与其他系统对接或者数据同步后，歌曲标识发生变化时进行相应修改。
+     * @param songId 要设置的歌曲标识字符串。
+     */
     public void setSongId(String songId) {
         this.songId = songId;
     }
 
+    /**
+     * 获取下载进度的方法，外部代码通过调用此方法可以获取到当前DownloadInfo对象所记录的歌曲下载进度的整数值，
+     * 一般可以据此在界面上展示给用户相应的进度百分比等信息。
+     * @return 返回表示下载进度的整数值（通常范围是0 - 100）。
+     */
     public int getProgress() {
         return progress;
     }
 
+    /**
+     * 设置下载进度的方法，用于更新当前DownloadInfo对象中的歌曲下载进度信息，
+     * 在下载过程中，根据实际下载的数据量等情况定时调用此方法来改变进度值，以实时反映下载状态。
+     * @param progress 要设置的下载进度整数值（通常范围是0 - 100）。
+     */
     public void setProgress(int progress) {
         this.progress = progress;
     }
 
+    /**
+     * 获取当前已下载文件大小的方法，外部代码调用此方法可获取到当前DownloadInfo对象记录的已下载部分的文件大小数值（单位一般为字节等），
+     * 常用于和总文件大小对比来展示下载进度情况。
+     * @return 返回表示当前已下载文件大小的长整型数值（单位如字节）。
+     */
     public long getCurrentSize() {
         return currentSize;
     }
 
+    /**
+     * 设置当前已下载文件大小的方法，用于更新当前DownloadInfo对象中的已下载文件大小信息，
+     * 在下载过程中，随着数据不断接收，会根据实际情况调用此方法来更新该值，以准确反映下载进展。
+     * @param currentSize 要设置的当前已下载文件大小的长整型数值（单位如字节）。
+     */
     public void setCurrentSize(long currentSize) {
         this.currentSize = currentSize;
     }
 
+    /**
+     * 获取歌曲文件总大小的方法，外部代码通过调用此方法可以获取到当前DownloadInfo对象所记录的歌曲文件整体大小数值（单位一般为字节等），
+     * 方便与当前已下载大小对比以及展示文件体量等情况。
+     * @return 返回表示歌曲文件总大小的长整型数值（单位如字节）。
+     */
     public long getTotalSize() {
         return totalSize;
     }
 
+    /**
+     * 设置歌曲文件总大小的方法，用于更新当前DownloadInfo对象中的歌曲文件总大小信息，
+     * 比如当获取到更准确的文件大小数据或者文件本身大小发生变化（如更新版本等情况）时进行修改。
+     * @param totalSize 要设置的歌曲文件总大小的长整型数值（单位如字节）。
+     */
     public void setTotalSize(long totalSize) {
         this.totalSize = totalSize;
     }
 
+    // 以下这部分代码对应的get和set方法由于关联的Song对象在当前代码中被注释掉未启用，所以暂时没有实际作用，
+    // 不过保留了代码结构，若后续需要启用可方便进行相关操作，此处仅展示代码，注释不再重复之前类似的说明
 //    public Song getSong() {
 //        return song;
 //    }
@@ -88,30 +204,65 @@ public class DownloadInfo extends LitePalSupport {
 //        this.song = song;
 //    }
 
+    /**
+     * 获取歌曲在下载列表中位置的方法，外部代码调用此方法可获取到当前DownloadInfo对象所记录的歌曲在下载列表里的位置索引整数值，
+     * 便于在界面展示列表等场景中进行定位和排序相关操作。
+     * @return 返回表示歌曲在下载列表中位置的整数值。
+     */
     public int getPosition() {
         return position;
     }
 
+    /**
+     * 设置歌曲在下载列表中位置的方法，用于更新当前DownloadInfo对象中的歌曲在下载列表里的位置信息，
+     * 例如当列表顺序发生变化或者新增、删除其他下载任务导致位置变动时进行相应修改。
+     * @param position 要设置的歌曲在下载列表中位置的整数值。
+     */
     public void setPosition(int position) {
         this.position = position;
     }
 
+    /**
+     * 获取下载信息记录主键的方法，外部代码通过调用此方法可以获取到当前DownloadInfo对象在数据库中的唯一标识值（长整型），
+     * 常用于数据库操作中对该条记录的精准查询、更新、删除等操作。
+     * @return 返回表示下载信息记录主键的长整型数值。
+     */
     public long getId() {
         return id;
     }
 
+    /**
+     * 获取下载歌曲状态的方法，外部代码调用此方法可获取到当前DownloadInfo对象所记录的歌曲下载状态的整数值，
+     * 进而根据不同状态值进行相应的界面展示或业务处理操作。
+     * @return 返回表示下载歌曲状态的整数值。
+     */
     public int getStatus() {
         return status;
     }
 
+    /**
+     * 设置下载歌曲状态的方法，用于更新当前DownloadInfo对象中的歌曲下载状态信息，
+     * 比如当下载任务的状态发生变化（如开始下载、暂停、完成、失败等情况）时调用此方法来改变状态值，以便系统知晓并处理相应情况。
+     * @param status 要设置的下载歌曲状态的整数值。
+     */
     public void setStatus(int status) {
         this.status = status;
     }
 
+    /**
+     * 获取歌曲时长的方法，外部代码通过调用此方法可以获取到当前DownloadInfo对象所记录的歌曲时长数值（单位一般为秒等），
+     * 方便展示歌曲播放长度等相关信息。
+     * @return 返回表示歌曲时长的长整型数值（单位如秒等）。
+     */
     public long getDuration() {
         return duration;
     }
 
+    /**
+     * 设置歌曲时长的方法，用于更新当前DownloadInfo对象中的歌曲时长信息，
+     * 例如当获取到更准确的歌曲时长数据或者歌曲版本更新导致时长变化时进行相应修改。
+     * @param duration 要设置的歌曲时长的长整型数值（单位如秒等）。
+     */
     public void setDuration(long duration) {
         this.duration = duration;
     }

app/src/main/java/com/example/musicplayer/entiy/DownloadSong.java

@@ -6,81 +6,193 @@ import org.litepal.crud.LitePalSupport;
  * <pre>
  *     author : 残渊
  *     time   : 2019/09/18
- *     desc   : 下载的歌曲
+ *     desc   : 该类用于表示已经下载的歌曲相关信息，包含了如歌曲的标识、名称、演唱者、下载链接、封面图片链接以及时长等属性，
+ *              旨在对下载完成后的歌曲进行统一的数据管理，方便在音乐播放器等应用中展示、播放已下载的歌曲内容。
  * </pre>
  */
-
+// 此类继承自LitePalSupport，意味着它能够借助LitePal框架提供的功能，轻松实现与数据库的交互，例如数据的存储、查询、更新和删除等操作，便于对下载歌曲信息进行持久化管理。
 public class DownloadSong extends LitePalSupport {
+    /**
+     * 用于唯一标识每一首下载歌曲记录的主键，在数据库存储中，它作为每条下载歌曲信息的独特标识，
+     * 通过这个标识可以准确地从数据库中查询、更新或者删除对应的歌曲记录，其取值通常由数据库根据自身规则自动生成或分配，一般为自增的整数类型。
+     */
     private int id;
-    private String songId ;
+    /**
-    private String mediaId; //下载标识符
+     * 歌曲的唯一标识，用于在整个音乐系统中准确地区分不同的歌曲，它可能与音乐平台后端数据库中的歌曲主键或者其他唯一编码相对应，
+     * 方便在涉及歌曲相关的各种操作（如播放、查找关联信息等）时进行精准定位，即使在不同的模块或业务场景下，也能通过这个标识确定具体是哪一首歌曲。
+     */
+    private String songId;
+    /**
+     * 下载标识符，可能是在下载过程中用于唯一标记这次下载任务或者该歌曲下载版本等相关情况的字符串，
+     * 例如在处理多线程下载、断点续传或者区分同一歌曲不同下载来源等场景中发挥作用，通过它可以准确追踪与此次下载相关的各种状态和信息。
+     */
+    private String mediaId;
+    /**
+     * 歌曲的名称，直观展示给用户这首歌曲的称呼，方便用户在已下载歌曲列表中快速识别和区分不同的歌曲，
+     * 一般是歌曲正式发布时所使用的名称，具有较高的可读性和唯一性，便于用户进行查找、播放等操作。
+     */
     private String name;
+    /**
+     * 歌曲的演唱者信息，明确了是哪位歌手或者演唱组合演唱了这首歌曲，有助于用户更好地了解歌曲的背景信息，
+     * 通常是歌手的真实姓名、艺名或者演唱组合的名称等具体的演唱主体相关的字符串表示。
+     */
     private String singer;
+    /**
+     * 歌曲文件的下载链接地址，这个链接指向了歌曲文件所在的网络位置或者本地存储位置（如果是本地资源的共享链接等情况），
+     * 通过该链接可以实现歌曲的下载操作，或者在需要重新获取歌曲文件（如文件损坏重新下载等情况）时再次发起请求获取资源。
+     */
     private String url;
+    /**
+     * 歌曲封面图片的链接地址，用于获取展示歌曲相关的封面图片资源，一般在音乐播放器界面等地方会通过这个链接加载对应的图片，
+     * 以增强歌曲展示的视觉效果，让用户更直观地感受到歌曲的整体风格和特色，提升用户体验。
+     */
     private String pic;
+    /**
+     * 歌曲的时长，单位通常为秒（s）或者毫秒（ms）等，它表示歌曲从开始播放到结束所持续的时间长度，
+     * 用户可以通过这个属性提前了解歌曲的长短情况，同时在播放相关的业务逻辑（如进度条展示、播放时间统计等）中也会用到该时长信息。
+     */
     private long duration;
 
+    /**
+     * 获取歌曲记录主键的方法，外部代码通过调用此方法可以获取到当前DownloadSong对象在数据库中对应的唯一标识值（整数类型），
+     * 常用于在数据库操作中准确地定位和操作这条歌曲记录，比如在更新歌曲信息或者删除该歌曲记录时需要使用这个主键值。
+     * @return 返回表示歌曲记录主键的整数值。
+     */
     public int getId() {
         return id;
     }
 
+    /**
+     * 设置歌曲记录主键的方法，一般情况下这个方法不会被外部随意调用，因为主键通常由数据库自动管理，
+     * 但在一些特殊的业务场景（如数据迁移、手动修正主键值等情况）下可能会用到，通过传入一个整数值来更新当前DownloadSong对象的主键信息。
+     * @param id 要设置的歌曲记录主键的整数值。
+     */
     public void setId(int id) {
         this.id = id;
     }
 
+    /**
+     * 获取歌曲名称的方法，外部代码调用此方法可以获取到当前DownloadSong对象所记录的歌曲名称信息（字符串类型），
+     * 方便在界面上展示歌曲名称，或者用于其他需要知晓歌曲称呼的业务逻辑中，例如在歌曲列表展示、搜索等功能中使用。
+     * @return 返回表示歌曲名称的字符串。
+     */
     public String getName() {
         return name;
     }
 
+    /**
+     * 设置歌曲名称的方法，用于更新当前DownloadSong对象中的歌曲名称信息，
+     * 比如当歌曲名称发生变更（如用户手动修改、从其他数据源同步到新的准确名称等情况）时，通过传入新的名称字符串来进行修改。
+     * @param name 要设置的歌曲名称字符串。
+     */
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * 获取歌曲演唱者信息的方法，外部代码调用此方法可获取到当前DownloadSong对象所记录的演唱者相关信息（字符串类型），
+     * 有助于在界面展示歌曲的演唱主体，或者在一些根据演唱者筛选歌曲等业务逻辑中使用该信息。
+     * @return 返回表示演唱者的字符串。
+     */
     public String getSinger() {
         return singer;
     }
 
+    /**
+     * 设置歌曲演唱者信息的方法，用于更新当前DownloadSong对象中的演唱者信息，
+     * 例如当发现演唱者信息有误或者获取到更准确的演唱主体名字时，通过传入新的演唱者字符串来进行相应修改。
+     * @param singer 要设置的演唱者信息字符串。
+     */
     public void setSinger(String singer) {
         this.singer = singer;
     }
 
+    /**
+     * 获取歌曲下载链接地址的方法，外部代码通过调用此方法可以获取到当前DownloadSong对象所记录的歌曲下载链接信息（字符串类型），
+     * 虽然歌曲已经下载完成，但这个链接在某些情况下（如文件丢失重新下载、检查链接有效性等）仍可能会被用到，比如重新发起下载请求。
+     * @return 返回表示下载链接的字符串。
+     */
     public String getUrl() {
         return url;
     }
 
+    /**
+     * 设置歌曲下载链接地址的方法，用于更新当前DownloadSong对象中的下载链接信息，
+     * 比如当原链接失效或者获取到新的有效下载链接（如资源更换服务器等情况）时，通过传入新的链接字符串来替换旧的链接信息。
+     * @param url 要设置的下载链接字符串。
+     */
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * 获取歌曲封面图片链接地址的方法，外部代码调用此方法可获取到当前DownloadSong对象所记录的歌曲封面图片链接信息（字符串类型），
+     * 以便在界面展示歌曲时能够根据这个链接加载对应的封面图片，提升歌曲展示的美观度和用户辨识度。
+     * @return 返回表示封面图片链接的字符串。
+     */
     public String getPic() {
         return pic;
     }
 
+    /**
+     * 设置歌曲封面图片链接地址的方法，用于更新当前DownloadSong对象中的封面图片链接信息，
+     * 例如当封面图片更新、更换图片来源或者原链接不可用等情况时，通过传入新的图片链接字符串来进行相应修改。
+     * @param pic 要设置的封面图片链接字符串。
+     */
     public void setPic(String pic) {
         this.pic = pic;
     }
 
-
+    /**
+     * 设置歌曲时长的方法，用于更新当前DownloadSong对象中的歌曲时长信息，
+     * 比如当获取到更准确的时长数据（可能是最初获取的时长有误或者歌曲版本更新导致时长变化等情况）时，通过传入新的时长数值来进行修改。
+     * @param duration 要设置的歌曲时长的长整型数值（单位如秒等）。
+     */
     public void setDuration(long duration) {
         this.duration = duration;
     }
 
+    /**
+     * 获取歌曲时长的方法，外部代码通过调用此方法可以获取到当前DownloadSong对象所记录的歌曲时长数值（长整型），
+     * 方便在界面展示歌曲时长信息，或者在播放相关的业务逻辑（如进度条根据时长计算进度、统计播放时长等）中使用该时长值。
+     * @return 返回表示歌曲时长的长整型数值（单位如秒等）。
+     */
     public long getDuration() {
         return duration;
     }
 
+    /**
+     * 设置歌曲唯一标识的方法，用于更新当前DownloadSong对象中的歌曲唯一标识信息，
+     * 例如在与其他音乐系统或数据源进行数据同步、整合时，歌曲的唯一标识可能发生变化，此时通过传入新的标识字符串来进行相应修改。
+     * @param songId 要设置的歌曲唯一标识的字符串。
+     */
     public void setSongId(String songId) {
         this.songId = songId;
     }
 
+    /**
+     * 获取歌曲唯一标识的方法，外部代码调用此方法可获取到当前DownloadSong对象所记录的歌曲唯一标识字符串，
+     * 便于在进行歌曲相关的各种操作（如查找关联信息、判断是否为同一首歌曲等）时使用该标识进行准确区分和定位。
+     * @return 返回表示歌曲唯一标识的字符串。
+     */
     public String getSongId() {
         return songId;
     }
 
+    /**
+     * 获取下载标识符的方法，外部代码调用此方法可获取到当前DownloadSong对象所记录的下载标识符字符串，
+     * 在涉及下载相关的特定业务逻辑（如断点续传、查询下载历史等）中可以通过这个标识符进行相应的操作和判断。
+     * @return 返回表示下载标识符的字符串。
+     */
     public String getMediaId() {
         return mediaId;
     }
 
+    /**
+     * 设置下载标识符的方法，用于更新当前DownloadSong对象中的下载标识符信息，
+     * 比如在下载过程中出现特殊情况需要重新标记下载任务、或者同一歌曲有不同下载版本需要区分等场景下，通过传入新的标识符字符串来进行修改。
+     * @param mediaId 要设置的下载标识符的字符串。
+     */
     public void setMediaId(String mediaId) {
         this.mediaId = mediaId;
     }

app/src/main/java/com/example/musicplayer/entiy/HistorySong.java

@@ -3,110 +3,264 @@ package com.example.musicplayer.entiy;
 import org.litepal.crud.LitePalSupport;
 
 /**
- * Created by 残渊 on 2018/12/2.
+ * <pre>
+ *     author : 残渊
+ *     time   : 2018/12/2
+ *     desc   : 该类用于表示历史播放歌曲的相关信息实体，旨在记录用户曾经播放过的歌曲的各项关键属性，
+ *              方便后续对播放历史进行管理、查询以及基于播放历史实现一些个性化功能（如根据历史推荐歌曲等）。
+ * </pre>
  */
-
+// HistorySong类继承自LitePalSupport类，借助LitePal框架提供的功能，能够方便地与数据库进行交互，
+// 例如将历史歌曲信息持久化存储到数据库中，从数据库里查询特定的历史歌曲记录，更新已有记录的属性值，或者删除不再需要的历史记录等操作，
+// 有助于高效管理和利用播放历史数据。
 public class HistorySong extends LitePalSupport {
+    /**
+     * 用于唯一标识每一条历史播放歌曲记录的标识符，在数据库存储中充当主键的角色，
+     * 每一首曾经播放过的歌曲在数据库里都有一个与之对应的唯一整数值，通过这个值可以精准地定位、查询、修改或者删除对应的历史歌曲记录，
+     * 通常由数据库按照自增等规则自动生成该主键值，以此保证每条记录都能被准确区分和操作，便于数据库层面的高效管理。
+     */
     private int id;
+    /**
+     * 歌曲在整个音乐系统中的唯一标识，类似于全局的身份编码，通过这个字符串类型的标识可以在不同的模块、数据源以及业务场景下准确区分每一首歌曲，
+     * 比如在关联歌曲的详细信息（如歌词、歌曲评论等）、与音乐服务器交互验证歌曲身份或者匹配播放列表中的歌曲时，都依靠这个唯一标识来确定具体的歌曲实体，
+     * 它与服务器端数据库中歌曲记录的对应标识字段相匹配，确保了数据的一致性和准确性，方便对歌曲进行全面的管理和操作。
+     */
     private String songId;
-    private String mediaId; //下载标识符
+    /**
+     * 下载标识符，与在下载相关业务逻辑中使用的标识符作用类似，此处用于区分历史播放歌曲的不同下载情况或者播放来源等，
+     * 例如当同一首歌曲有多次不同条件的下载或者通过不同渠道播放时，mediaId可以起到唯一标记的作用，便于追溯歌曲的播放历史背景，
+     * 同时在涉及断点续播、记录播放资源来源等场景下，这个标识符也能提供关键的区分和定位信息，确保播放历史记录的准确性和完整性。
+     */
+    private String mediaId;
+    /**
+     * 可能是与QQ音乐平台相关的唯一标识（从变量名推测），如果音乐播放器支持与QQ音乐进行数据交互或者整合，
+     * 这个标识可以用于在QQ音乐的系统中准确查找对应的歌曲资源、匹配用户在QQ音乐上的相关操作记录（如收藏、分享等），
+     * 方便实现跨平台的数据关联和功能融合，具体含义和使用方式取决于应用与QQ音乐的集成程度和业务逻辑要求。
+     */
     private String qqId;
+    /**
+     * 歌曲的名称，以直观易懂的字符串形式呈现给用户，用于在历史播放列表等界面展示中让用户快速识别出曾经播放过的是哪首歌曲，
+     * 一般遵循歌曲发布时的官方命名，具有较高的规范性和唯一性，便于用户回顾和查找自己感兴趣的歌曲，也是展示播放历史的重要信息之一。
+     */
     private String name;
+    /**
+     * 歌曲的演唱者信息，明确指出了是哪位歌手或者演唱组合演绎了这首歌曲，以字符串形式存储演唱主体的名称，
+     * 在历史播放记录展示中，用户可以通过演唱者信息更好地了解歌曲的背景，同时也方便基于演唱者进行播放历史的筛选、分类等操作，
+     * 例如用户可能想要查看某个特定歌手的歌曲播放历史情况，就可以通过这个属性来实现相应的功能。
+     */
     private String singer;
+    /**
+     * 歌曲文件的来源链接地址，它指向了歌曲资源所在的具体位置，这个位置既可能是网络上的服务器地址（常见于在线播放的情况），
+     * 也可能是本地存储路径（例如播放本地已下载歌曲时），通过这个链接，音乐播放器可以在需要重新获取歌曲文件（如重新播放、验证文件有效性等情况）时发起相应的请求，
+     * 确保歌曲资源的可用性，并且在记录播放历史时保留这个链接有助于后续追溯歌曲的播放来源。
+     */
     private String url;
+    /**
+     * 歌曲封面图片的链接地址，用于获取与这首歌曲相关联的封面图片资源，通常以网络链接的形式存在，
+     * 在音乐播放器的历史播放记录界面展示中，通过这个链接可以加载对应的图片并展示在相应的歌曲条目上，
+     * 精美的封面图片不仅能够提升界面的美观度，还能帮助用户更直观地回忆起歌曲的风格特点，增强用户查看播放历史的体验。
+     */
     private String pic;
+    /**
+     * 歌曲的时长信息，以长整型数据来表示歌曲从开始播放到结束所持续的时间长度，单位通常为秒（s）或者毫秒（ms），具体取决于应用的内部设定，
+     * 在历史播放记录中记录歌曲时长，一方面可以让用户回顾歌曲的长短情况，另一方面在一些基于播放时长的统计分析（如统计用户听歌总时长等）业务中也会用到该属性。
+     */
     private long duration;
+    /**
+     * 用于标识歌曲是否为在线播放的状态，取值为布尔类型，true表示歌曲是通过在线方式播放的（即从网络服务器获取歌曲资源进行播放），
+     * false表示歌曲可能是本地已下载的或者通过其他离线方式播放的，这个属性有助于对播放历史进行分类统计，了解用户的在线、离线播放习惯等情况。
+     */
     private boolean isOnline;
+    /**
+     * 用于标识歌曲是否已经被下载到本地的状态，同样是布尔类型，true表示歌曲已经下载到本地存储中，
+     * false则表示歌曲未被下载，只是进行了在线播放等情况，通过这个属性可以清晰地知晓用户播放历史中歌曲的下载情况，
+     * 方便在后续推荐、管理本地资源等业务逻辑中基于此进行相应的操作和判断。
+     */
     private boolean isDownload;
 
-
+    /**
-
+     * 获取当前历史播放歌曲记录在数据库中的唯一标识（主键）的方法，外部代码通过调用此方法，
+     * 能够获取到一个整数值，该值可用于在数据库相关操作（如查询、更新、删除该歌曲记录等）中准确地定位到对应的记录，
+     * 保证数据库操作的准确性和针对性，是数据库层面操作历史歌曲记录的关键入口之一。
+     * @return 返回表示歌曲记录主键的整数值。
+     */
     public int getId() {
         return id;
     }
 
+    /**
+     * 设置当前历史播放歌曲记录在数据库中的唯一标识（主键）的方法，不过一般情况下，
+     * 这个主键值由数据库自动管理和分配，很少会被外部代码直接调用修改，
+     * 只有在特定的业务场景下（如数据迁移过程中需要手动调整主键值、数据库记录出现异常需要修正主键等情况）才会使用，
+     * 通过传入一个合法的整数值来更新当前HistorySong对象的主键信息。
+     * @param id 要设置的歌曲记录主键的整数值。
+     */
     public void setId(int id) {
         this.id = id;
     }
 
+    /**
+     * 获取歌曲名称的方法，外部代码调用此方法后，会返回一个字符串，该字符串即为当前HistorySong对象所代表的历史播放歌曲的名称，
+     * 在历史播放记录的界面展示（如历史播放列表展示、详细历史记录查看等场景）以及其他基于歌曲名称的业务逻辑（如搜索历史播放歌曲等）中，
+     * 这个方法提供了获取歌曲名称信息的途径，方便进行相应的操作和展示。
+     * @return 返回表示歌曲名称的字符串。
+     */
     public String getName() {
         return name;
     }
 
+    /**
+     * 设置歌曲名称的方法，当出现歌曲名称需要变更的情况时（例如歌曲在音乐平台上更新了官方名称、用户手动修改了本地保存的歌曲名称等），
+     * 外部代码可以通过传入一个新的字符串作为参数来更新当前HistorySong对象中的歌曲名称属性，
+     * 确保歌曲名称信息在历史记录中的准确性和及时性，便于用户准确识别和回顾播放过的歌曲。
+     * @param name 要设置的歌曲名称字符串。
+     */
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * 获取歌曲演唱者信息的方法，调用此方法后，外部代码将获取到一个字符串，该字符串代表了演唱这首历史播放歌曲的歌手或者演唱组合的名称，
+     * 在历史播放记录展示中，通过展示演唱者信息可以让用户更好地了解歌曲背景，同时在基于演唱者的相关业务操作（如按照演唱者筛选历史播放歌曲等）中，
+     * 这个方法提供了关键的演唱者信息获取途径，方便进行分类管理和查询。
+     * @return 返回表示演唱者的字符串。
+     */
     public String getSinger() {
         return singer;
     }
 
+    /**
+     * 设置歌曲演唱者信息的方法，当发现已保存的演唱者信息不准确或者获取到了更准确的演唱主体名称时（比如数据源更新了演唱者信息等情况），
+     * 外部代码可以通过传入正确的演唱者名称字符串来更新当前HistorySong对象中的演唱者属性，
+     * 使得历史播放歌曲相关信息始终保持准确可靠，便于用户准确回顾播放历史。
+     * @param singer 要设置的演唱者信息字符串。
+     */
     public void setSinger(String singer) {
         this.singer = singer;
     }
 
+    /**
+     * 获取歌曲文件来源链接地址的方法，外部代码调用此方法会返回一个字符串，这个字符串就是指向歌曲文件所在位置的链接，
+     * 在历史播放记录中保留这个链接有助于后续追溯歌曲的播放来源，比如当需要重新播放歌曲或者验证歌曲资源是否有效时，
+     * 可以依据这个链接发起相应的请求，确保歌曲资源的可用性，同时也方便进行一些基于播放来源的统计分析等业务操作。
+     * @return 返回表示下载链接的字符串。
+     */
     public String getUrl() {
         return url;
     }
 
+    /**
+     * 设置歌曲文件来源链接地址的方法，当原有的下载链接出现问题（如链接失效、服务器更换地址等情况）或者获取到了新的有效下载链接时，
+     * 外部代码可以通过传入新的链接字符串作为参数来更新当前HistorySong对象中的下载链接属性，
+     * 确保后续在需要重新获取歌曲文件时能够顺利进行操作，保证历史播放记录中链接信息的准确性和有效性。
+     * @param url 要设置的下载链接字符串。
+     */
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * 获取歌曲封面图片链接地址的方法，调用此方法后，外部代码将得到一个字符串，这个字符串指向了与该歌曲相关联的封面图片资源所在位置，
+     * 在历史播放记录的界面展示环节（如在历史播放列表中展示封面缩略图、在详细历史记录界面展示高清封面等），
+     * 可以依据这个链接去加载对应的图片，提升界面的美观度，帮助用户更直观地回忆起歌曲的风格特点，增强用户查看历史播放记录的体验。
+     * @return 返回表示封面图片链接的字符串。
+     */
     public String getPic() {
         return pic;
     }
 
+    /**
+     * 设置歌曲封面图片链接地址的方法，当封面图片发生变更（如图片更新、更换了图片来源、原链接不可用等情况）时，
+     * 外部代码可以通过传入新的封面图片链接字符串来更新当前HistorySong对象中的封面图片链接属性，
+     * 保证界面能够展示正确、美观的封面图片，让历史播放记录的展示更加准确和吸引人。
+     * @param pic 要设置的封面图片链接字符串。
+     */
     public void setPic(String pic) {
         this.pic = pic;
     }
 
-
+    /**
+     * 获取歌曲在整个音乐系统中的唯一标识的方法，外部代码调用此方法后，会得到一个字符串，
+     * 这个字符串就是当前HistorySong对象所代表的历史播放歌曲在整个音乐系统中的唯一标识，
+     * 在进行与歌曲相关的各种操作（如查找关联信息、判断两首歌曲是否为同一首等）时，
+     * 可以依靠这个标识进行准确的区分和定位，确保历史播放记录中歌曲数据的准确性和一致性，方便数据的管理和利用。
+     * @return 返回表示歌曲唯一标识的字符串。
+     */
     public String getSongId() {
         return songId;
     }
 
+    /**
+     * 设置歌曲在整个音乐系统中的唯一标识的方法，在一些特定业务场景下（如与其他音乐系统或数据源进行数据同步、整合，
+     * 导致歌曲的唯一标识发生变化等情况），外部代码可以通过传入新的歌曲唯一标识字符串作为参数，
+     * 来更新当前HistorySong对象中的歌曲Id属性，保证歌曲在不同系统或业务场景间能够准确对应和识别，维持历史播放记录数据的准确性。
+     * @param songId 要设置的歌曲唯一标识的字符串。
+     */
     public void setSongId(String songId) {
         this.songId = songId;
     }
 
+    /**
+     * 设置歌曲在线播放状态的方法，通过传入一个布尔值作为参数，来更新当前HistorySong对象中的isOnline属性，
+     * 用于在确定歌曲播放方式发生变化（如从在线播放变为离线播放，或者反之）等情况下，及时更新历史播放记录中的在线状态信息，
+     * 便于后续对用户在线、离线播放习惯等进行准确的统计和分析。
+     * @param online 要设置的表示歌曲是否在线播放的布尔值，true表示在线播放，false表示离线播放。
+     */
     public void setOnline(boolean online) {
         isOnline = online;
     }
 
+    /**
+     * 获取歌曲在线播放状态的方法，外部代码调用此方法后，会返回一个布尔值，该布尔值表示当前HistorySong对象所对应的历史播放歌曲是否是通过在线方式播放的，
+     * 在进行基于播放方式的分类统计、界面展示（如区分显示在线和离线播放历史记录）等业务操作中，
+     * 这个方法提供了获取歌曲在线状态信息的途径，方便进行相应的判断和处理。
+     * @return 返回表示歌曲是否在线播放的布尔值，true表示在线播放，false表示离线播放。
+     */
     public boolean isOnline() {
         return isOnline;
     }
 
+    /**
+     * 获取歌曲时长信息的方法，外部代码调用此方法后，会返回一个长整型数值，该数值代表了当前HistorySong对象所对应的历史播放歌曲的时长，
+     * 在历史播放记录展示（如显示歌曲时长给用户查看）以及基于播放时长的统计分析（如统计用户听歌总时长等）业务操作中，
+     * 这个方法提供了获取歌曲时长的途径，方便进行相应的操作和展示。
+     * @return 返回表示歌曲时长的长整型数值（单位如秒等）。
+     */
     public long getDuration() {
         return duration;
     }
 
+    /**
+     * 设置歌曲时长信息的方法，当获取到了更准确的歌曲时长数据（例如最初记录的时长有误、歌曲版本更新导致时长发生变化等情况）时，
+     * 外部代码可以通过传入一个代表正确时长的长整型数值作为参数，来更新当前HistorySong对象中的歌曲时长属性，
+     * 确保时长信息在历史播放记录中的准确性，以便在相关业务逻辑中正确使用该时长数据。
+     * @param duration 要设置的歌曲时长的长整型数值（单位如秒等）。
+     */
     public void setDuration(long duration) {
         this.duration = duration;
     }
 
+    /**
+     * 获取与QQ音乐平台相关的唯一标识（推测用途）的方法，外部代码调用此方法后，会得到一个字符串，
+     * 这个字符串就是当前HistorySong对象对应的QQ音乐相关标识，在涉及与QQ音乐进行数据交互、关联用户在QQ音乐上的操作记录等业务场景中，
+     * 这个标识起到了关键的定位和匹配作用，方便实现跨平台的数据整合和功能拓展。
+     * @return 返回表示QQ音乐相关标识的字符串。
+     */
     public String getQqId() {
         return qqId;
     }
 
+    /**
+     * 设置与QQ音乐平台相关的唯一标识（推测用途）的方法，当在与QQ音乐的数据交互过程中，获取到了新的标识信息或者需要更新该标识时，
+     * 外部代码可以通过传入新的QQ音乐相关标识字符串作为参数，来更新当前HistorySong对象中的qqId属性，
+     * 确保跨平台数据关联的准确性和有效性，便于更好地整合和利用QQ音乐相关的数据资源。
+     * @param qqId 要设置的QQ音乐相关标识的字符串。
+     */
     public void setQqId(String qqId) {
         this.qqId = qqId;
     }
 
-    public String getMediaId() {
+/**
-        return mediaId;
+ * 获取下载标识符的方法，外部代码调用此方法后，会得到一个字符串，该字符串就是当前HistorySong对象对应的下载标识符，
-    }
+ * 在涉及追溯歌曲的下载情况、区分不同播放来源以及基于下载相关业务逻辑（如断点续播等）的操作中，
-
+ * 这个标识符起到了关键
-    public void setMediaId(String mediaId) {
-        this.mediaId = mediaId;
-    }
-
-    public void setDownload(boolean download) {
-        isDownload = download;
-    }
-
-    public boolean isDownload() {
-        return isDownload;
-    }
-}

app/src/main/java/com/example/musicplayer/entiy/LocalSong.java

@@ -4,80 +4,224 @@ import org.litepal.LitePal;
 import org.litepal.crud.LitePalSupport;
 
 /**
- * Created by 残渊 on 2018/10/10.
+ * <pre>
+ *     author : 残渊
+ *     time   : 2018/10/10
+ *     desc   : 该类用于表示本地歌曲的相关信息实体，旨在对存储在本地设备中的歌曲各项关键属性进行记录和管理，
+ *              方便音乐播放器在本地音乐播放场景下，对这些歌曲进行展示、播放以及相关操作的处理等。
+ * </pre>
  */
-
+// LocalSong类继承自LitePalSupport类，这样它就能借助LitePal框架提供的便捷功能，轻松实现与本地数据库的交互操作，
-public class LocalSong extends LitePalSupport{
+// 例如可以方便地将本地歌曲信息保存到数据库中（持久化存储），从数据库里查询符合特定条件的本地歌曲记录，
+// 更新已有本地歌曲记录的属性值，或者删除不再需要的本地歌曲记录等，有助于高效地管理本地歌曲数据资源。
+public class LocalSong extends LitePalSupport {
+    /**
+     * 用于唯一标识每一首本地歌曲记录的标识符，在数据库存储中充当主键的角色，
+     * 每一首存储在本地的歌曲在数据库里都会有一个与之对应的唯一整数值，通过这个值能够精准地定位、查询、修改或者删除对应的本地歌曲记录，
+     * 一般情况下，该主键值由数据库按照自身既定的规则（比如常见的自增规则）自动生成，以此保证每条本地歌曲记录都能被准确区分和操作，便于数据库层面的高效管理。
+     */
     private int id;
-    private String songId ;
+    /**
+     * 歌曲在整个音乐系统中的唯一标识，这是一个字符串类型的标识，它能够在不同的模块、数据源以及业务场景下准确区分每一首歌曲，
+     * 比如在关联歌曲的详细信息（像歌词、歌曲评论等内容，如果存在相应的关联机制）、与外部音乐服务器（若有交互需求）验证歌曲身份，
+     * 或者在多个播放列表中匹配具体歌曲时，都会依靠这个唯一标识来确定具体的歌曲实体，它确保了歌曲数据在整个音乐生态系统中的一致性和准确性。
+     */
+    private String songId;
+    /**
+     * 可能是与QQ音乐平台相关的唯一标识（从变量名推测），如果音乐播放器支持与QQ音乐进行数据交互或者整合，
+     * 这个标识可以用于在QQ音乐的系统中准确查找对应的歌曲资源、匹配用户在QQ音乐上的相关操作记录（如收藏、分享等），
+     * 方便实现跨平台的数据关联和功能融合，不过具体含义和使用方式取决于应用与QQ音乐的集成程度以及相应的业务逻辑要求。
+     */
     private String qqId;
+    /**
+     * 歌曲的名称，以直观易懂的字符串形式呈现给用户，是用户识别本地歌曲的重要依据，通常遵循歌曲发布时的官方命名，
+     * 具有较高的规范性和唯一性，便于用户在本地歌曲列表中快速找到自己想听的歌曲，同时也是在界面展示本地歌曲时最直观展示的信息之一。
+     */
     private String name;
+    /**
+     * 歌曲的演唱者信息，明确指出了是哪位歌手或者演唱组合演绎了这首歌曲，以字符串形式存储演唱主体的名称，
+     * 用户通过查看演唱者信息能更好地了解歌曲的风格、背景等情况，并且在本地歌曲管理中，也方便基于演唱者进行歌曲的分类、筛选等操作，
+     * 例如用户可以查找某个特定歌手的所有本地歌曲来创建个性化的播放列表等。
+     */
     private String singer;
+    /**
+     * 歌曲文件在本地存储的路径或者网络链接（如果支持本地网络共享播放等情况），它指向了歌曲资源所在的具体位置，
+     * 通过这个链接或者路径，音乐播放器能够准确地找到歌曲文件并进行播放操作，同时在对本地歌曲资源进行管理（如文件迁移、验证文件有效性等）时，
+     * 这个属性也起着关键的作用，确保本地歌曲资源的正确获取和使用。
+     */
     private String url;
+    /**
+     * 歌曲封面图片的链接地址，用于获取与这首歌曲相关联的封面图片资源，一般以网络链接的形式存在（也可能是本地图片路径，取决于应用设计），
+     * 在音乐播放器的本地歌曲展示界面中，通过这个链接可以加载对应的图片并展示在相应的歌曲条目上，
+     * 精美的封面图片不仅能够提升界面的美观度，还能帮助用户更直观地感受到歌曲的风格特点，增强用户体验。
+     */
     private String pic;
+    /**
+     * 歌曲的时长信息，以长整型数据来表示歌曲从开始播放到结束所持续的时间长度，单位通常为秒（s）或者毫秒（ms），具体取决于应用的内部设定，
+     * 在本地歌曲管理中，这个属性可以让用户提前了解歌曲的长短情况，方便用户根据自己的时间安排选择播放；
+     * 同时在播放相关的业务逻辑（如进度条的时长计算、显示已播放和剩余播放时间，以及统计用户的播放时长等功能实现）中也有着重要作用。
+     */
     private long duration;
 
+    /**
+     * 获取当前本地歌曲记录在数据库中的唯一标识（主键）的方法，外部代码通过调用此方法，
+     * 能够获取到一个整数值，该值可用于在数据库相关操作（如查询、更新、删除该歌曲记录等）中准确地定位到对应的记录，
+     * 保证数据库操作的准确性和针对性，是对本地歌曲记录进行数据库层面操作的关键入口之一。
+     * @return 返回表示歌曲记录主键的整数值。
+     */
     public int getId() {
         return id;
     }
 
-    public void setId(int id) {
+    /**
+     * 设置当前本地歌曲记录在数据库中的唯一标识（主键）的方法，不过正常情况下，
+     * 这个主键值由数据库自动管理和分配，很少会被外部代码直接调用修改，
+     * 只有在一些特殊的业务场景下（如数据迁移过程中需要手动调整主键值、数据库记录出现异常需要修正主键等情况）才会使用，
+     * 通过传入一个合法的整数值来更新当前LocalSong对象的主键信息。
+     * @param id 要设置的歌曲记录主键的整数值。
+     */
+    public int setId(int id) {
         this.id = id;
+        return this.id;
     }
 
+    /**
+     * 获取歌曲名称的方法，外部代码调用此方法后，会返回一个字符串，该字符串即为当前LocalSong对象所代表的本地歌曲的名称，
+     * 在本地歌曲列表展示、搜索本地歌曲以及其他基于歌曲名称的业务逻辑（如按照名称排序等）中，
+     * 这个方法提供了获取歌曲名称信息的途径，方便进行相应的操作和展示。
+     * @return 返回表示歌曲名称的字符串。
+     */
     public String getName() {
         return name;
     }
 
+    /**
+     * 设置歌曲名称的方法，当出现歌曲名称需要变更的情况时（例如歌曲在音乐平台上更新了官方名称、用户手动修改了本地保存的歌曲名称等），
+     * 外部代码可以通过传入一个新的字符串作为参数来更新当前LocalSong对象中的歌曲名称属性，
+     * 确保歌曲名称信息在本地歌曲管理中的准确性和及时性，便于用户准确识别和播放本地歌曲。
+     * @param name 要设置的歌曲名称字符串。
+     */
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * 获取歌曲演唱者信息的方法，调用此方法后，外部代码将获取到一个字符串，该字符串代表了演唱这首本地歌曲的歌手或者演唱组合的名称，
+     * 在本地歌曲展示界面中通过展示演唱者信息可以让用户更好地了解歌曲背景，同时在基于演唱者的相关业务操作（如按照演唱者筛选本地歌曲等）中，
+     * 这个方法提供了关键的演唱者信息获取途径，方便进行分类管理和查询。
+     * @return 返回表示演唱者的字符串。
+     */
     public String getSinger() {
         return singer;
     }
 
+    /**
+     * 设置歌曲演唱者信息的方法，当发现已保存的演唱者信息不准确或者获取到了更准确的演唱主体名称时（比如数据源更新了演唱者信息等情况），
+     * 外部代码可以通过传入正确的演唱者名称字符串来更新当前LocalSong对象中的演唱者属性，
+     * 使得本地歌曲相关信息始终保持准确可靠，便于用户准确识别和管理本地歌曲。
+     * @param singer 要设置的演唱者信息字符串。
+     */
     public void setSinger(String singer) {
         this.singer = singer;
     }
 
+    /**
+     * 获取歌曲文件所在位置（路径或链接）的方法，外部代码调用此方法会返回一个字符串，这个字符串就是指向歌曲文件所在位置的信息，
+     * 在音乐播放器对本地歌曲进行播放、管理（如文件验证、迁移等操作）时，依据这个位置信息能够准确找到歌曲文件，
+     * 确保本地歌曲资源的可用性和正确使用，同时也方便进行一些基于文件位置的统计分析等业务操作。
+     * @return 返回表示歌曲文件位置（路径或链接）的字符串。
+     */
     public String getUrl() {
         return url;
     }
 
+    /**
+     * 设置歌曲文件所在位置（路径或链接）的方法，当原有的文件位置信息发生变化（如文件移动到新的本地路径、网络共享链接变更等情况）或者获取到了新的有效位置信息时，
+     * 外部代码可以通过传入新的位置信息字符串作为参数来更新当前LocalSong对象中的url属性，
+     * 确保后续在需要获取歌曲文件时能够顺利进行操作，保证本地歌曲管理中文件位置信息的准确性和有效性。
+     * @param url 要设置的歌曲文件位置（路径或链接）的字符串。
+     */
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * 获取歌曲封面图片链接地址的方法，调用此方法后，外部代码将得到一个字符串，这个字符串指向了与该歌曲相关联的封面图片资源所在位置，
+     * 在本地歌曲展示的界面环节（如在本地歌曲列表中展示封面缩略图、在播放界面展示高清封面等），
+     * 可以依据这个链接去加载对应的图片，提升界面的美观度，帮助用户更直观地感受到歌曲的风格特点，增强用户查看本地歌曲的体验。
+     * @return 返回表示封面图片链接的字符串。
+     */
     public String getPic() {
         return pic;
     }
 
+    /**
+     * 设置歌曲封面图片链接地址的方法，当封面图片发生变更（如图片更新、更换了图片来源、原链接不可用等情况）时，
+     * 外部代码可以通过传入新的封面图片链接字符串来更新当前LocalSong对象中的封面图片链接属性，
+     * 保证界面能够展示正确、美观的封面图片，让本地歌曲展示更加准确和吸引人。
+     * @param pic 要设置的封面图片链接字符串。
+     */
     public void setPic(String pic) {
         this.pic = pic;
     }
 
-
+    /**
+     * 设置歌曲时长信息的方法，当获取到了更准确的歌曲时长数据（例如最初记录的时长有误、歌曲版本更新导致时长发生变化等情况）时，
+     * 外部代码可以通过传入一个代表正确时长的长整型数值作为参数，来更新当前LocalSong对象中的歌曲时长属性，
+     * 确保时长信息在本地歌曲管理中的准确性，以便在播放等相关业务逻辑中正确使用该时长数据。
+     * @param duration 要设置的歌曲时长的长整型数值（单位如秒等）。
+     */
     public void setDuration(long duration) {
         this.duration = duration;
     }
 
+    /**
+     * 获取歌曲时长信息的方法，外部代码调用此方法后，会返回一个长整型数值，该数值代表了当前LocalSong对象所对应的本地歌曲的时长，
+     * 在本地歌曲展示（如显示歌曲时长给用户查看）以及播放相关的业务逻辑（如进度条根据时长计算播放进度、统计用户播放时长等）中，
+     * 这个方法提供了获取歌曲时长的途径，方便进行相应的操作和展示。
+     * @return 返回表示歌曲时长的长整型数值（单位如秒等）。
+     */
     public long getDuration() {
         return duration;
     }
 
+    /**
+     * 设置歌曲在整个音乐系统中的唯一标识的方法，在一些特定业务场景下（如与其他音乐系统或数据源进行数据同步、整合，
+     * 导致歌曲的唯一标识发生变化等情况），外部代码可以通过传入新的歌曲唯一标识字符串作为参数，
+     * 来更新当前LocalSong对象中的songId属性，保证歌曲在不同系统或业务场景间能够准确对应和识别，维持本地歌曲数据的准确性。
+     * @param songId 要设置的歌曲唯一标识的字符串。
+     */
     public void setSongId(String songId) {
         this.songId = songId;
     }
 
+    /**
+     * 获取歌曲在整个音乐系统中的唯一标识的方法，外部代码调用此方法后，会得到一个字符串，
+     * 这个字符串就是当前LocalSong对象所代表的本地歌曲在整个音乐系统中的唯一标识，
+     * 在进行与歌曲相关的各种操作（如查找关联信息、判断两首歌曲是否为同一首等）时，
+     * 可以依靠这个标识进行准确的区分和定位，确保本地歌曲数据的准确性和一致性，方便数据的管理和利用。
+     * @return 返回表示歌曲唯一标识的字符串。
+     */
     public String getSongId() {
         return songId;
     }
 
+    /**
+     * 获取与QQ音乐平台相关的唯一标识（推测用途）的方法，外部代码调用此方法后，会得到一个字符串，
+     * 这个字符串就是当前LocalSong对象对应的QQ音乐相关标识，在涉及与QQ音乐进行数据交互、关联用户在QQ音乐上的操作记录等业务场景中，
+     * 这个标识起到了关键的定位和匹配作用，方便实现跨平台的数据整合和功能拓展。
+     * @return 返回表示QQ音乐相关标识的字符串。
+     */
     public String getQqId() {
         return qqId;
     }
 
+    /**
+     * 设置与QQ音乐平台相关的唯一标识（推测用途）的方法，当在与QQ音乐的数据交互过程中，获取到了新的标识信息或者需要更新该标识时，
+     * 外部代码可以通过传入新的QQ音乐相关标识字符串作为参数，来更新当前LocalSong对象中的qqId属性，
+     * 确保跨平台数据关联的准确性和有效性，便于更好地整合和利用QQ音乐相关的数据资源。
+     * @param qqId 要设置的QQ音乐相关标识的字符串。
+     */
     public void setQqId(String qqId) {
         this.qqId = qqId;
     }

app/src/main/java/com/example/musicplayer/entiy/Love.java

@@ -3,109 +3,265 @@ package com.example.musicplayer.entiy;
 import org.litepal.crud.LitePalSupport;
 
 /**
- * Created by 残渊 on 2018/11/30.
+ * <pre>
+ *     author : 残渊
+ *     time   : 2018/11/30
+ *     desc   : 该类用于表示用户喜爱的歌曲相关信息实体，旨在记录那些被用户标记为“喜爱”的歌曲的各项关键属性，
+ *              方便后续根据用户的喜好进行相关功能实现，例如个性化推荐、创建喜爱歌曲播放列表等操作。
+ * </pre>
  */
-
+// Love类继承自LitePalSupport类，这使得它能够利用LitePal框架提供的功能，便捷地与数据库进行交互，
-public class Love extends LitePalSupport{
+// 比如可以将用户喜爱歌曲的信息持久化存储到数据库中，方便后续查询、更新这些喜爱歌曲的记录，或者根据业务需求删除某些不再喜爱的歌曲记录等，
+// 有助于有效地管理用户的歌曲喜好数据。
+public class Love extends LitePalSupport {
+    /**
+     * 用于唯一标识每一条用户喜爱歌曲记录的标识符，在数据库存储中充当主键的角色，
+     * 每一首被用户标记为喜爱的歌曲在数据库里都有一个与之对应的唯一整数值，通过这个值可以精准地定位、查询、修改或者删除对应的喜爱歌曲记录，
+     * 通常该主键值由数据库按照自增等既定规则自动生成，以此确保每条记录都能被清晰区分，便于数据库层面高效地对喜爱歌曲数据进行管理操作。
+     */
     private int id;
+    /**
+     * 歌曲在整个音乐系统中的唯一标识，是一个字符串类型的标识，它能够在不同的模块、数据源以及业务场景下准确区分每一首歌曲，
+     * 例如在关联歌曲的详细信息（如歌词、歌曲评论等）、与音乐服务器交互验证歌曲身份或者在多个播放列表中匹配具体的喜爱歌曲时，
+     * 都依靠这个唯一标识来确定具体的歌曲实体，保证了歌曲数据在整个音乐应用生态中的一致性和准确性。
+     */
     private String songId;
-    private String mediaId; //下载标识符
+    /**
+     * 下载标识符，类似于在下载相关业务逻辑中使用的特定标识，在这里用于区分用户喜爱歌曲的不同下载情况或者播放来源等，
+     * 比如同一首喜爱的歌曲可能有多次不同条件的下载经历，或者通过不同渠道播放，mediaId就可以起到唯一标记的作用，便于追溯歌曲的相关背景信息，
+     * 同时在涉及断点续播、记录播放资源来源等与播放相关的场景下，这个标识符也能提供关键的区分和定位信息，确保喜爱歌曲记录的完整性和准确性。
+     */
+    private String mediaId;
+    /**
+     * 可能是与QQ音乐平台相关的唯一标识（从变量名推测），若音乐播放器支持与QQ音乐进行数据交互或者整合，
+     * 这个标识可以用于在QQ音乐的系统中准确查找对应的歌曲资源、匹配用户在QQ音乐上的相关操作记录（如收藏、分享等），
+     * 方便实现跨平台的数据关联和功能融合，具体的使用方式和含义取决于应用与QQ音乐的集成程度以及相应的业务逻辑要求。
+     */
     private String qqId;
+    /**
+     * 歌曲的名称，以直观易懂的字符串形式呈现给用户，是用户识别喜爱歌曲的重要依据，一般遵循歌曲发布时的官方命名，
+     * 具有较高的规范性和唯一性，便于用户在喜爱歌曲列表等界面快速找到自己心仪的歌曲，也是展示喜爱歌曲信息的关键内容之一。
+     */
     private String name;
+    /**
+     * 歌曲的演唱者信息，明确指出了是哪位歌手或者演唱组合演绎了这首歌曲，以字符串形式存储演唱主体的名称，
+     * 在喜爱歌曲展示界面中，用户可以通过演唱者信息更好地了解歌曲的背景，同时也方便基于演唱者进行喜爱歌曲的分类、筛选等操作，
+     * 例如用户可以查找某个特定歌手的所有喜爱歌曲来创建专属的播放列表等。
+     */
     private String singer;
+    /**
+     * 歌曲文件的来源链接地址，它指向了歌曲资源所在的具体位置，这个位置既可能是网络上的服务器地址（常见于在线播放喜爱歌曲的情况），
+     * 也可能是本地存储路径（例如喜爱的本地已下载歌曲），通过这个链接，音乐播放器可以在需要重新获取歌曲文件（如重新播放、验证文件有效性等情况）时发起相应的请求，
+     * 确保歌曲资源的可用性，并且在管理喜爱歌曲信息时保留这个链接有助于后续追溯歌曲的播放来源等情况。
+     */
     private String url;
+    /**
+     * 歌曲封面图片的链接地址，用于获取与这首歌曲相关联的封面图片资源，通常以网络链接的形式存在，
+     * 在音乐播放器的喜爱歌曲展示界面中，通过这个链接可以加载对应的图片并展示在相应的歌曲条目上，
+     * 精美的封面图片不仅能够提升界面的美观度，还能帮助用户更直观地感受到歌曲的风格特点，增强用户查看喜爱歌曲列表的体验。
+     */
     private String pic;
+    /**
+     * 歌曲的时长信息，以长整型数据来表示歌曲从开始播放到结束所持续的时间长度，单位通常为秒（s）或者毫秒（ms），具体取决于应用的内部设定，
+     * 在喜爱歌曲管理中，这个属性可以让用户提前了解歌曲的长短情况，方便用户根据自己的时间安排选择播放；
+     * 同时在播放相关的业务逻辑（如进度条的时长计算、显示已播放和剩余播放时间，以及统计用户的播放时长等功能实现）中也有着重要作用。
+     */
     private long duration;
+    /**
+     * 用于标识歌曲是否为在线播放的状态，取值为布尔类型，true表示歌曲是通过在线方式播放的（即从网络服务器获取歌曲资源进行播放），
+     * false表示歌曲可能是本地已下载的或者通过其他离线方式播放的，这个属性有助于对喜爱歌曲进行分类统计，了解用户喜爱的在线、离线播放歌曲的情况，
+     * 也能为后续根据播放方式进行个性化推荐等功能提供数据支持。
+     */
     private boolean isOnline;
+    /**
+     * 用于标识歌曲是否已经被下载到本地的状态，同样是布尔类型，true表示歌曲已经下载到本地存储中，
+     * false则表示歌曲未被下载，只是进行了在线播放等情况，通过这个属性可以清晰地知晓用户喜爱歌曲的下载情况，
+     * 方便在后续推荐、管理本地资源等业务逻辑中基于此进行相应的操作和判断，例如优先推荐本地已下载的喜爱歌曲等。
+     */
     private boolean isDownload;
 
-
+    /**
+     * 获取当前喜爱歌曲记录在数据库中的唯一标识（主键）的方法，外部代码通过调用此方法，
+     * 能够获取到一个整数值，该值可用于在数据库相关操作（如查询、更新、删除该歌曲记录等）中准确地定位到对应的记录，
+     * 保证数据库操作的准确性和针对性，是对喜爱歌曲记录进行数据库层面操作的关键入口之一。
+     * @return 返回表示歌曲记录主键的整数值。
+     */
     public int getId() {
         return id;
     }
 
+    /**
+     * 设置当前喜爱歌曲记录在数据库中的唯一标识（主键）的方法，不过一般情况下，
+     * 这个主键值由数据库自动管理和分配，很少会被外部代码直接调用修改，
+     * 只有在特定的业务场景下（如数据迁移过程中需要手动调整主键值、数据库记录出现异常需要修正主键等情况）才会使用，
+     * 通过传入一个合法的整数值来更新当前Love对象的主键信息。
+     * @param id 要设置的歌曲记录主键的整数值。
+     */
     public void setId(int id) {
         this.id = id;
     }
 
+    /**
+     * 获取歌曲名称的方法，外部代码调用此方法后，会返回一个字符串，该字符串即为当前Love对象所代表的喜爱歌曲的名称，
+     * 在喜爱歌曲列表展示、搜索喜爱歌曲以及其他基于歌曲名称的业务逻辑（如按照名称排序等）中，
+     * 这个方法提供了获取歌曲名称信息的途径，方便进行相应的操作和展示。
+     * @return 返回表示歌曲名称的字符串。
+     */
     public String getName() {
         return name;
     }
 
+    /**
+     * 设置歌曲名称的方法，当出现歌曲名称需要变更的情况时（例如歌曲在音乐平台上更新了官方名称、用户手动修改了本地保存的歌曲名称等），
+     * 外部代码可以通过传入一个新的字符串作为参数来更新当前Love对象中的歌曲名称属性，
+     * 确保歌曲名称信息在喜爱歌曲管理中的准确性和及时性，便于用户准确识别和播放喜爱歌曲。
+     * @param name 要设置的歌曲名称字符串。
+     */
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * 获取歌曲演唱者信息的方法，调用此方法后，外部代码将获取到一个字符串，该字符串代表了演唱这首喜爱歌曲的歌手或者演唱组合的名称，
+     * 在喜爱歌曲展示界面中通过展示演唱者信息可以让用户更好地了解歌曲背景，同时在基于演唱者的相关业务操作（如按照演唱者筛选喜爱歌曲等）中，
+     * 这个方法提供了关键的演唱者信息获取途径，方便进行分类管理和查询。
+     * @return 返回表示演唱者的字符串。
+     */
     public String getSinger() {
         return singer;
     }
 
+    /**
+     * 设置歌曲演唱者信息的方法，当发现已保存的演唱者信息不准确或者获取到了更准确的演唱主体名称时（比如数据源更新了演唱者信息等情况），
+     * 外部代码可以通过传入正确的演唱者名称字符串来更新当前Love对象中的演唱者属性，
+     * 使得喜爱歌曲相关信息始终保持准确可靠，便于用户准确识别和管理喜爱歌曲。
+     * @param singer 要设置的演唱者信息字符串。
+     */
     public void setSinger(String singer) {
         this.singer = singer;
     }
 
+    /**
+     * 获取歌曲文件来源链接地址的方法，外部代码调用此方法会返回一个字符串，这个字符串就是指向歌曲文件所在位置的链接，
+     * 在喜爱歌曲管理中，依据这个链接可以在需要时重新获取歌曲文件，比如重新播放歌曲或者验证文件有效性等，
+     * 同时也方便进行一些基于歌曲来源的统计分析等业务操作，确保歌曲资源的可用性。
+     * @return 返回表示下载链接的字符串。
+     */
     public String getUrl() {
         return url;
     }
 
+    /**
+     * 设置歌曲文件来源链接地址的方法，当原有的下载链接出现问题（如链接失效、服务器更换地址等情况）或者获取到了新的有效下载链接时，
+     * 外部代码可以通过传入新的链接字符串作为参数来更新当前Love对象中的下载链接属性，
+     * 确保后续在需要重新获取歌曲文件时能够顺利进行操作，保证喜爱歌曲管理中链接信息的准确性和有效性。
+     * @param url 要设置的下载链接字符串。
+     */
     public void setUrl(String url) {
         this.url = url;
     }
 
+    /**
+     * 获取歌曲封面图片链接地址的方法，调用此方法后，外部代码将得到一个字符串，这个字符串指向了与该歌曲相关联的封面图片资源所在位置，
+     * 在喜爱歌曲展示的界面环节（如在喜爱歌曲列表中展示封面缩略图、在播放界面展示高清封面等），
+     * 可以依据这个链接去加载对应的图片，提升界面的美观度，帮助用户更直观地感受到歌曲的风格特点，增强用户查看喜爱歌曲列表的体验。
+     * @return 返回表示封面图片链接的字符串。
+     */
     public String getPic() {
         return pic;
     }
 
+    /**
+     * 设置歌曲封面图片链接地址的方法，当封面图片发生变更（如图片更新、更换了图片来源、原链接不可用等情况）时，
+     * 外部代码可以通过传入新的封面图片链接字符串来更新当前Love对象中的封面图片链接属性，
+     * 保证界面能够展示正确、美观的封面图片，让喜爱歌曲展示更加准确和吸引人。
+     * @param pic 要设置的封面图片链接字符串。
+     */
     public void setPic(String pic) {
         this.pic = pic;
     }
 
-
+    /**
+     * 获取歌曲在整个音乐系统中的唯一标识的方法，外部代码调用此方法后，会得到一个字符串，
+     * 这个字符串就是当前Love对象所代表的喜爱歌曲在整个音乐系统中的唯一标识，
+     * 在进行与歌曲相关的各种操作（如查找关联信息、判断两首歌曲是否为同一首等）时，
+     * 可以依靠这个标识进行准确的区分和定位，确保喜爱歌曲数据的准确性和一致性，方便数据的管理和利用。
+     * @return 返回表示歌曲唯一标识的字符串。
+     */
     public String getSongId() {
         return songId;
     }
 
+    /**
+     * 设置歌曲在整个音乐系统中的唯一标识的方法，在一些特定业务场景下（如与其他音乐系统或数据源进行数据同步、整合，
+     * 导致歌曲的唯一标识发生变化等情况），外部代码可以通过传入新的歌曲唯一标识字符串作为参数，
+     * 来更新当前Love对象中的songId属性，保证歌曲在不同系统或业务场景间能够准确对应和识别，维持喜爱歌曲数据的准确性。
+     * @param songId 要设置的歌曲唯一标识的字符串。
+     */
     public void setSongId(String songId) {
         this.songId = songId;
     }
 
+    /**
+     * 设置歌曲在线播放状态的方法，通过传入一个布尔值作为参数，来更新当前Love对象中的isOnline属性，
+     * 用于在确定歌曲播放方式发生变化（如从在线播放变为离线播放，或者反之）等情况下，及时更新喜爱歌曲记录中的在线状态信息，
+     * 便于后续对用户喜爱的在线、离线播放歌曲情况进行准确的统计和分析，也能为相关推荐功能提供数据依据。
+     * @param online 要设置的表示歌曲是否在线播放的布尔值，true表示在线播放，false表示离线播放。
+     */
     public void setOnline(boolean online) {
         isOnline = online;
     }
 
+    /**
+     * 获取歌曲在线播放状态的方法，外部代码调用此方法后，会返回一个布尔值，该布尔值表示当前Love对象所对应的喜爱歌曲是否是通过在线方式播放的，
+     * 在进行基于播放方式的分类统计、界面展示（如区分显示喜爱的在线和离线播放歌曲等）等业务操作中，
+     * 这个方法提供了获取歌曲在线状态信息的途径，方便进行相应的判断和处理。
+     * @return 返回表示歌曲是否在线播放的布尔值，true表示在线播放，false表示离线播放。
+     */
     public boolean isOnline() {
         return isOnline;
     }
 
+    /**
+     * 获取歌曲时长信息的方法，外部代码调用此方法后，会返回一个长整型数值，该数值代表了当前Love对象所对应的喜爱歌曲的时长，
+     * 在喜爱歌曲展示（如显示歌曲时长给用户查看）以及播放相关的业务逻辑（如进度条根据时长计算播放进度、统计用户播放时长等）中，
+     * 这个方法提供了获取歌曲时长的途径，方便进行相应的操作和展示。
+     * @return 返回表示歌曲时长的长整型数值（单位如秒等）。
+     */
     public long getDuration() {
         return duration;
     }
 
+    /**
+     * 设置歌曲时长信息的方法，当获取到了更准确的歌曲时长数据（例如最初记录的时长有误、歌曲版本更新导致时长发生变化等情况）时，
+     * 外部代码可以通过传入一个代表正确时长的长整型数值作为参数，来更新当前Love对象中的歌曲时长属性，
+     * 确保时长信息在喜爱歌曲管理中的准确性，以便在相关业务逻辑中正确使用该时长数据。
+     * @param duration 要设置的歌曲时长的长整型数值（单位如秒等）。
+     */
     public void setDuration(long duration) {
         this.duration = duration;
     }
 
-    public void setQqId(String qqId) {
+    /**
-        this.qqId = qqId;
+     * 获取与QQ音乐平台相关的唯一标识（推测用途）的方法，外部代码调用此方法后，会得到一个字符串，
-    }
+     * 这个字符串就是当前Love对象对应的QQ音乐相关标识，在涉及与QQ音乐进行数据交互、关联用户在QQ音乐上的操作记录等业务场景中，
-
+     * 这个标识起到了关键的定位和匹配作用，方便实现跨平台的数据整合和功能拓展。
+     * @return 返回表示QQ音乐相关标识的字符串。
+     */
     public String getQqId() {
         return qqId;
     }
 
-    public String getMediaId() {
+    /**
-        return mediaId;
+     * 设置与QQ音乐平台相关的唯一标识（推测用途）的方法，当在与QQ音乐的数据交互过程中，获取到了新的标识信息或者需要更新该标识时，
-    }
+     * 外部代码可以通过传入新的QQ音乐相关标识字符串作为参数，来更新当前Love对象中的qqId属性，
-
+     * 确保跨平台数据关联的准确性和有效性，便于更好地整合和利用QQ音乐相关的数据资源。
-    public void setMediaId(String mediaId) {
+     * @param qqId 要设置的QQ音乐相关标识的字符串。
-        this.mediaId = mediaId;
+     */
-    }
+    public void setQqId(String qqId) {
-
+        this.qqId = qqId;
-    public boolean isDownload() {
-        return isDownload;
     }
 
-    public void setDownload(boolean download) {
+/**
-        isDownload = download;
+ * 获取下载标识符的方法，外部代码调用此方法后，会得到一个字符串，该字符串就是当前Love对象对应的下载标识符，
-    }
+ * 在涉及追溯歌曲的下载情况、区分不同播放来源以及基于下载相关业务逻辑（如断点续播等）的操作中，
-}

app/src/main/java/com/example/musicplayer/entiy/LrcBean.java

@@ -4,46 +4,103 @@ package com.example.musicplayer.entiy;
  * <pre>
  *     author : 残渊
  *     time   : 2019/03/18
- *     desc   : 歌词实体类
+ *     desc   : 该类作为歌词实体类，用于封装歌词相关的关键信息，主要包含歌词文本内容以及每句歌词对应的开始时间和结束时间，
+ *              旨在方便音乐播放器在播放歌曲时，能依据这些信息准确地展示对应的歌词内容，实现歌词与歌曲播放进度的同步展示等功能。
  * </pre>
  */
-
 public class LrcBean {
-    private String lrc;  //歌词
+    /**
-    private long start;  //开始时间
+     * 用于存储具体的歌词文本内容，每一行歌词以字符串的形式记录在这里，整体构成了一首歌曲完整的歌词信息，
-    private long end;   //结束时间
+     * 例如："我和我最后的倔强，握紧双手绝对不放" 这样的一句歌词就会作为字符串存放在此变量中，方便后续提取和展示给用户观看。
+     */
+    private String lrc;
+    /**
+     * 表示歌词开始展示的时间点，以长整型数据记录，单位通常为毫秒（ms），这个时间是相对于歌曲开始播放的时刻来计算的，
+     * 它标记了这句歌词应该在歌曲播放到多长时间的时候开始出现在界面上，以便实现歌词与歌曲播放进度的精准同步，
+     * 比如某句歌词的开始时间为10000毫秒（即歌曲播放到10秒时），音乐播放器就会在此时将这句歌词显示出来。
+     */
+    private long start;
+    /**
+     * 表示歌词结束展示的时间点，同样以长整型数据记录，单位为毫秒（ms），该时间界定了这句歌词应该在歌曲播放到多久之后不再显示，
+     * 与开始时间配合，确定了每句歌词在屏幕上展示的时间区间，确保歌词展示的时效性和准确性，与歌曲播放进度紧密匹配，
+     * 例如某句歌词开始时间是10000毫秒，结束时间是15000毫秒，那么就在歌曲播放的10秒到15秒这个时间段内展示这句歌词。
+     */
+    private long end;
 
+    /**
+     * 默认的无参构造函数，用于创建LrcBean对象时，在不需要传入初始参数的情况下初始化对象，
+     * 例如在一些场景中，先创建对象，后续再通过相应的set方法来设置歌词、开始时间和结束时间等属性的值。
+     */
     public LrcBean() {
     }
 
+    /**
+     * 带有参数的构造函数，用于在创建LrcBean对象的同时，直接传入歌词文本、开始时间和结束时间的具体值来初始化对象，
+     * 方便在已知歌词具体信息的情况下，快速创建一个包含完整歌词相关属性的对象，减少后续单独设置属性的步骤，提高代码编写效率，
+     * 例如：LrcBean lrcBean = new LrcBean("我和我最后的倔强，握紧双手绝对不放", 10000, 15000); 就可以快速创建一个对应歌词信息的对象。
+     * @param text 要设置的歌词文本内容字符串。
+     * @param start 要设置的歌词开始时间，单位为毫秒（ms）的长整型数值。
+     * @param end 要设置的歌词结束时间，单位为毫秒（ms）的长整型数值。
+     */
     public LrcBean(String text, long start, long end) {
         this.lrc = text;
         this.start = start;
         this.end = end;
     }
 
+    /**
+     * 获取歌词文本内容的方法，外部代码通过调用此方法，可以获取到当前LrcBean对象所存储的具体歌词字符串信息，
+     * 在音乐播放器的歌词展示模块中，会调用这个方法来获取歌词文本，然后将其显示在对应的界面位置上，方便用户查看歌曲的歌词内容。
+     * @return 返回表示歌词文本内容的字符串。
+     */
     public String getLrc() {
         return lrc;
     }
 
+    /**
+     * 设置歌词文本内容的方法，当需要更新歌词内容（比如歌词存在错误需要修正、获取到了更准确的歌词版本等情况）时，
+     * 外部代码可以通过传入新的歌词字符串作为参数，来更新当前LrcBean对象中的歌词属性，确保歌词信息的准确性和及时性。
+     * @param lrc 要设置的歌词文本内容字符串。
+     */
     public void setLrc(String lrc) {
         this.lrc = lrc;
     }
 
+    /**
+     * 获取歌词开始时间的方法，外部代码调用此方法后，会返回一个长整型数值，该数值代表了当前LrcBean对象所对应的歌词的开始展示时间，
+     * 在音乐播放器实现歌词与歌曲播放进度同步的功能中，会依据这个开始时间来判断何时将歌词显示在界面上，确保歌词展示的准确性。
+     * @return 返回表示歌词开始时间的长整型数值，单位为毫秒（ms）。
+     */
     public long getStart() {
         return start;
     }
 
+    /**
+     * 设置歌词开始时间的方法，当发现歌词开始展示的时间不准确（比如最初解析歌词时间戳有误、歌曲节奏调整导致歌词展示时间变化等情况）时，
+     * 外部代码可以通过传入一个新的代表正确开始时间的长整型数值（单位为毫秒）作为参数，来更新当前LrcBean对象中的开始时间属性，
+     * 保证歌词能在正确的歌曲播放时刻开始显示。
+     * @param start 要设置的歌词开始时间，单位为毫秒（ms）的长整型数值。
+     */
     public void setStart(long start) {
         this.start = start;
     }
 
+    /**
+     * 获取歌词结束时间的方法，外部代码调用此方法后，会返回一个长整型数值，该数值代表了当前LrcBean对象所对应的歌词的结束展示时间，
+     * 在音乐播放器的歌词展示逻辑中，会根据这个结束时间来判断何时将歌词从界面上移除，确保歌词展示区间与歌曲播放进度相符。
+     * @return 返回表示歌词结束时间的长整型数值，单位为毫秒（ms）。
+     */
     public long getEnd() {
         return end;
     }
 
+    /**
+     * 设置歌词结束时间的方法，当歌词结束展示的时间需要调整（比如由于歌曲时长变化、歌词节奏适配等原因导致结束时间改变）时，
+     * 外部代码可以通过传入一个新的代表正确结束时间的长整型数值（单位为毫秒）作为参数，来更新当前LrcBean对象中的结束时间属性，
+     * 保证歌词展示的时间区间准确无误。
+     * @param end 要设置的歌词结束时间，单位为毫秒（ms）的长整型数值。
+     */
     public void setEnd(long end) {
         this.end = end;
     }
 }
-

app/src/main/java/com/example/musicplayer/entiy/OnlineSong.java

@@ -4,106 +4,189 @@ import org.litepal.crud.LitePalSupport;
 
 /**
  * Created by 残渊 on 2018/11/27.
+ * 这个类表示在线歌曲的相关信息实体，用于存储和管理在线歌曲的各项属性。
+ * 它继承自LitePalSupport类，借助LitePal框架可以方便地与数据库进行交互操作，
+ * 例如将在线歌曲信息持久化存储到数据库、从数据库查询、更新或删除在线歌曲记录等，以实现对在线歌曲数据的有效管理。
  */
-
 public class OnlineSong extends LitePalSupport {
+    // 用于唯一标识每一首在线歌曲记录的标识符，在数据库中充当主键的角色。
+    // 数据库通常会按照自增等规则自动生成该值，通过它能精准定位、查询、修改或删除对应的在线歌曲记录，方便数据库层面的管理。
     private int id;
+    // 歌曲在整个音乐系统中的唯一标识，是一个字符串类型的标识，用于在不同模块、数据源及业务场景下准确区分每一首歌曲。
+    // 比如关联歌词、歌曲评论，与服务器交互验证歌曲身份，或在播放列表中匹配具体歌曲时，都依赖它来确定歌曲实体，保证数据一致性和准确性。
     private String songId;
-    private String mediaId; //下载标识符
+    // 下载标识符，主要用于区分在线歌曲不同的下载情况或者播放来源等情况。
+    // 例如同一首歌有多次不同下载经历、通过不同渠道播放时，该标识符可起到唯一标记作用，便于追溯相关背景信息，
+    // 在断点续播、记录播放资源来源等场景下也能提供关键区分和定位信息，确保在线歌曲记录的完整性和准确性。
+    private String mediaId;
+    // 可能是与QQ音乐平台相关的唯一标识（从变量名推测），若应用支持与QQ音乐交互或整合，
+    // 可借助该标识在QQ音乐系统中查找对应歌曲资源、匹配用户在QQ音乐上的相关操作记录（如收藏、分享等），
+    // 方便实现跨平台的数据关联和功能融合，具体使用方式取决于与QQ音乐的集成程度及相应业务逻辑要求。
     private String qqId;
+    // 歌曲的名称，以直观易懂的字符串形式呈现给用户，遵循歌曲官方命名，具有规范性和唯一性，
+    // 便于用户在在线歌曲列表等界面快速识别想听的歌曲，是展示在线歌曲信息的关键内容之一。
     private String name;
+    // 歌曲的演唱者信息，以字符串形式存储演唱主体的名称，通过它用户能了解歌曲背景，
+    // 同时方便基于演唱者进行在线歌曲的分类、筛选等操作，比如查找特定歌手的所有在线歌曲来创建播放列表。
     private String singer;
+    // 歌曲文件的网络链接地址，指向歌曲资源所在的网络位置，音乐播放器依靠该链接发起网络请求获取歌曲文件进行在线播放，
+    // 在验证链接有效性、处理网络播放异常等资源管理方面，该属性起着关键作用，确保在线歌曲能正常播放。
     private String url;
+    // 歌曲封面图片的链接地址，通常为网络链接形式，用于获取与歌曲相关联的封面图片资源。
+    // 在在线歌曲展示界面上，依据该链接加载图片展示在相应歌曲条目上，提升界面美观度，帮助用户直观感受歌曲风格特点，增强用户体验。
     private String pic;
+    // 歌曲的歌词文本内容，以字符串形式存储整首歌曲的歌词，音乐播放器播放在线歌曲时，会结合歌词对应的时间信息（如有），
+    // 根据该内容将歌词展示给用户，方便用户跟唱或查看具体歌词内容。
     private String lrc;
+    // 歌曲的时长信息，以长整型数据表示歌曲从开始播放到结束持续的时间长度，单位通常为秒（s）或毫秒（ms），取决于应用内部设定。
+    // 它能让用户提前了解歌曲长短以便安排播放，在播放相关业务逻辑（如进度条时长计算、已播放和剩余时间显示、用户播放时长统计等）中有重要作用。
     private long duration;
+    // 用于标识歌曲是否已经被下载到本地的状态，布尔类型。true表示歌曲已下载到本地，false表示仅在线播放，未下载到本地。
+    // 通过该属性可清晰知晓在线歌曲的下载情况，便于后续推荐、管理本地资源等业务逻辑中基于此进行相应操作和判断。
     private boolean isDownload;
 
-
+    // 获取当前在线歌曲记录在数据库中的唯一标识（主键）的方法。
+    // 外部代码调用此方法可获取相应整数值，用于数据库相关操作（如查询、更新、删除记录等）中准确定位对应的记录，保证操作准确性和针对性。
     public int getId() {
         return id;
     }
 
+    // 设置当前在线歌曲记录在数据库中的唯一标识（主键）的方法。
+    // 一般情况下，该主键值由数据库自动管理和分配，很少被外部代码直接调用修改，
+    // 仅在特殊业务场景（如数据迁移、数据库记录异常修正主键等情况）下，通过传入合法整数值来更新主键信息。
     public void setId(int id) {
         this.id = id;
     }
 
+    // 获取歌曲名称的方法。
+    // 外部代码调用此方法后，会返回代表当前在线歌曲名称的字符串，用于在线歌曲列表展示、搜索、排序等业务逻辑中获取名称信息进行操作展示。
     public String getName() {
         return name;
     }
 
+    // 设置歌曲名称的方法。
+    // 当歌曲名称有变更需求（如官方名称更新、用户手动修改等情况）时，外部代码传入新字符串作为参数来更新当前对象中的歌曲名称属性，
+    // 确保名称信息准确及时，便于用户准确识别和播放在线歌曲。
     public void setName(String name) {
         this.name = name;
     }
 
+    // 获取歌曲演唱者信息的方法。
+    // 调用后，外部代码可获取到代表演唱这首在线歌曲的歌手或演唱组合名称的字符串，用于展示歌曲背景及基于演唱者的分类、筛选等操作。
     public String getSinger() {
         return singer;
     }
 
+    // 设置歌曲演唱者信息的方法。
+    // 当已保存的演唱者信息不准确或获取到更准确名称时（如数据源更新等情况），外部代码传入正确的演唱者名称字符串来更新该属性，
+    // 保证在线歌曲相关信息准确可靠，便于用户准确识别和管理在线歌曲。
     public void setSinger(String singer) {
         this.singer = singer;
     }
 
+    // 获取歌曲文件网络链接地址的方法。
+    // 外部代码调用此方法会返回指向歌曲文件所在网络位置的字符串，用于音乐播放器发起网络请求获取歌曲文件进行播放，
+    // 以及进行链接有效性验证、处理网络播放异常等资源管理相关操作。
     public String getUrl() {
         return url;
     }
 
+    // 设置歌曲文件网络链接地址的方法。
+    // 当原链接出现问题（如失效、服务器更换地址等）或获取到新有效链接时，外部代码传入新链接字符串作为参数来更新该属性，
+    // 确保后续能顺利获取歌曲文件，保证链接信息的准确性和有效性。
     public void setUrl(String url) {
         this.url = url;
     }
 
+    // 获取歌曲封面图片链接地址的方法。
+    // 调用后，外部代码可获取到指向歌曲封面图片资源所在位置的字符串，用于在在线歌曲展示界面加载图片，提升界面美观度和用户体验。
     public String getPic() {
         return pic;
     }
 
+    // 设置歌曲封面图片链接地址的方法。
+    // 当封面图片有变更（如更新、更换来源、原链接不可用等情况）时，外部代码传入新封面图片链接字符串来更新该属性，
+    // 保证界面能展示正确、美观的封面图片，使在线歌曲展示更准确吸引人。
     public void setPic(String pic) {
         this.pic = pic;
     }
 
+    // 获取歌曲歌词文本内容的方法。
+    // 外部代码调用此方法后，会返回代表当前在线歌曲歌词内容的字符串，供音乐播放器在播放时展示歌词给用户查看或跟唱。
     public String getLrc() {
         return lrc;
     }
 
+    // 设置歌曲歌词文本内容的方法。
+    // 当获取到更准确的歌词数据（如最初歌词有误、歌曲版本更新致歌词变化等情况）时，外部代码传入新歌词字符串作为参数来更新该属性，
+    // 确保歌词信息准确，以便正确展示歌词内容给用户。
     public void setLrc(String lrc) {
         this.lrc = lrc;
     }
 
+    // 获取歌曲在整个音乐系统中的唯一标识的方法。
+    // 外部代码调用此方法后，会得到相应字符串，用于在进行与歌曲相关各种操作（如查找关联信息、判断两首歌是否同一首等）时，
+    // 依靠该标识准确区分和定位歌曲，确保在线歌曲数据的准确性和一致性，方便数据管理和利用。
     public String getSongId() {
         return songId;
     }
 
+    // 设置歌曲在整个音乐系统中的唯一标识的方法。
+    // 在特定业务场景（如与其他音乐系统或数据源数据同步、整合导致标识变化等情况）下，外部代码传入新的唯一标识字符串作为参数，
+    // 来更新当前对象中的歌曲Id属性，保证歌曲在不同系统或场景间准确对应和识别，维持数据准确性。
     public void setSongId(String songId) {
         this.songId = songId;
     }
 
+    // 设置歌曲时长信息的方法。
+    // 当获取到更准确的时长数据（如最初记录有误、歌曲版本更新致时长变化等情况）时，外部代码传入代表正确时长的长整型数值作为参数，
+    // 来更新当前对象中的歌曲时长属性，确保时长信息准确，便于在相关业务逻辑中正确使用该数据。
     public void setDuration(long duration) {
         this.duration = duration;
     }
 
+    // 获取歌曲时长信息的方法。
+    // 外部代码调用此方法后，会返回代表当前在线歌曲时长的长整型数值，用于在线歌曲展示（如显示时长给用户）及播放相关业务逻辑操作。
     public long getDuration() {
         return duration;
     }
 
+    // 获取与QQ音乐平台相关的唯一标识（推测用途）的方法。
+    // 外部代码调用此方法后，会得到相应字符串，在涉及与QQ音乐进行数据交互、关联用户在QQ音乐上操作记录等业务场景中，
+    // 该标识起到关键定位和匹配作用，方便实现跨平台的数据整合和功能拓展。
     public String getQqId() {
         return qqId;
     }
 
+    // 设置与QQ音乐平台相关的唯一标识（推测用途）的方法。
+    // 在与QQ音乐数据交互过程中，当获取到新标识信息或需更新该标识时，外部代码传入新的QQ音乐相关标识字符串作为参数，
+    // 来更新当前对象中的qqId属性，确保跨平台数据关联准确有效，便于更好地整合利用QQ音乐相关数据资源。
     public void setQqId(String qqId) {
         this.qqId = qqId;
     }
 
+    // 获取下载标识符的方法。
+    // 外部代码调用此方法后，会得到相应字符串，在追溯歌曲下载情况、区分不同播放来源及基于下载相关业务逻辑（如断点续播等）操作中，
+    // 该标识符起到关键区分和定位作用，方便进行相应操作和判断。
     public String getMediaId() {
         return mediaId;
     }
 
+    // 设置下载标识符的方法。
+    // 当需要更新该标识符时（例如下载任务重新开始、同一歌曲有新下载版本需区分等情况），外部代码传入新的下载标识符字符串作为参数，
+    // 来更新当前对象中的mediaId属性，确保下载相关业务逻辑的准确性和可追溯性。
     public void setMediaId(String mediaId) {
         this.mediaId = mediaId;
     }
 
+    // 设置歌曲是否已下载到本地状态的方法。
+    // 通过传入布尔值参数来更新当前对象中的isDownload属性，用于在歌曲下载状态发生变化时及时更新记录，便于后续相关业务逻辑处理。
     public void setDownload(boolean download) {
         isDownload = download;
     }
 
+    // 获取歌曲是否已下载到本地状态的方法。
+    // 外部代码调用此方法后，返回布尔值表示当前在线歌曲是否已下载到本地，用于判断歌曲下载情况，辅助业务逻辑操作，如推荐本地歌曲等。
     public boolean isDownload() {
         return isDownload;
     }

app/src/main/java/com/example/musicplayer/entiy/OnlineSongLrc.java

@@ -4,26 +4,59 @@ package com.example.musicplayer.entiy;
  * <pre>
  *     author : 残渊
  *     time   : 2019/09/04
- *     desc   : qq音乐平台的网络歌词
+ *     desc   : 该类用于表示QQ音乐平台的网络歌词相关信息实体，旨在对从QQ音乐平台获取到的歌词数据进行封装，
+ *              方便音乐播放器在处理与QQ音乐相关的歌词业务（如解析、展示等）时使用这些信息，确保歌词数据能准确地与对应的歌曲配合使用。
  * </pre>
  */
-
 public class OnlineSongLrc {
+    /**
+     * 用于存储从QQ音乐平台获取歌词时返回的状态码，通常不同的整数值代表不同的状态情况，
+     * 例如，可能0表示获取成功，其他非零值表示各种错误情况（如网络连接失败、歌词不存在等），
+     * 通过这个状态码，音乐播放器可以判断歌词获取操作是否顺利完成，进而决定后续如何处理歌词数据或者向用户反馈相应的提示信息。
+     */
     private int code;
+    /**
+     * 用于存储从QQ音乐平台获取到的具体歌词文本内容，以字符串的形式保存整首歌曲的歌词信息，
+     * 其格式可能遵循QQ音乐平台的歌词数据格式规范（比如包含时间戳标记等用于歌词同步展示的格式信息），
+     * 在音乐播放器中，会根据这个歌词文本结合相应的解析逻辑，将歌词准确地展示给用户，实现与歌曲播放进度的同步显示等功能。
+     */
     private String lyric;
 
+    /**
+     * 设置歌词文本内容的方法，当从QQ音乐平台获取到新的歌词数据或者对已有的歌词文本进行更新（例如歌词有修正版本等情况）时，
+     * 外部代码可以通过传入新的歌词字符串作为参数，来更新当前OnlineSongLrc对象中的歌词属性，确保歌词信息的准确性和及时性，以便正确展示给用户。
+     * @param lyric 要设置的歌词文本内容字符串。
+     */
     public void setLyric(String lyric) {
         this.lyric = lyric;
     }
 
+    /**
+     * 设置从QQ音乐平台获取歌词时返回的状态码的方法，在接收到QQ音乐平台的响应后，根据实际返回的状态码情况，
+     * 外部代码可以通过传入对应的整数值来更新当前OnlineSongLrc对象中的状态码属性，
+     * 使得音乐播放器能够依据这个状态码准确判断歌词获取操作的结果，进而采取合适的后续处理措施。
+     * @param code 要设置的表示歌词获取状态的整数值。
+     */
     public void setCode(int code) {
         this.code = code;
     }
 
+    /**
+     * 获取从QQ音乐平台获取歌词时返回的状态码的方法，外部代码调用此方法后，会返回一个整数值，
+     * 该数值代表了歌词获取操作的最终状态，音乐播放器可以根据这个返回值来判断是否成功获取到歌词以及是否出现了异常情况等，
+     * 例如可以通过判断返回值是否为0来确定是否顺利获取歌词，进而决定后续的业务逻辑走向，比如展示歌词或者提示用户获取失败等。
+     * @return 返回表示歌词获取状态的整数值。
+     */
     public int getCode() {
         return code;
     }
 
+    /**
+     * 获取从QQ音乐平台获取到的歌词文本内容的方法，外部代码调用此方法后，会返回一个字符串，
+     * 这个字符串就是对应的歌曲的歌词信息，音乐播放器会依据这个歌词文本，按照相应的展示逻辑（如根据时间戳同步展示等），
+     * 将歌词呈现给用户，方便用户跟唱或者查看歌曲的具体歌词内容。
+     * @return 返回表示歌词文本内容的字符串。
+     */
     public String getLyric() {
         return lyric;
     }

app/src/main/java/com/example/musicplayer/entiy/SearchHistory.java

@@ -3,25 +3,67 @@ package com.example.musicplayer.entiy;
 import org.litepal.crud.LitePalSupport;
 
 /**
- * Created by 残渊 on 2018/11/29.
+ * <pre>
+ *     author : 残渊
+ *     time   : 2018/11/29
+ *     desc   : 该类用于表示搜索历史的相关信息实体，旨在记录用户在音乐播放器中进行搜索操作时输入的关键词等历史信息，
+ *              方便后续根据这些搜索历史实现一些功能，比如提供搜索历史记录列表方便用户快速再次搜索，或者基于历史搜索内容进行数据分析等。
+ * </pre>
  */
-
+// SearchHistory类继承自LitePalSupport类，借助LitePal框架提供的功能，可以方便地与数据库进行交互，
+// 例如将搜索历史信息持久化存储到数据库中，以便后续能从数据库里查询特定的搜索历史记录、更新已有记录的内容，
+// 或者根据业务需求删除某些不再需要的搜索历史记录等，有助于高效地管理用户的搜索历史数据。
 public class SearchHistory extends LitePalSupport {
+    /**
+     * 用于存储用户曾经输入的具体搜索内容，也就是搜索历史信息，以字符串的形式记录下来，
+     * 例如用户输入过“周杰伦的歌曲”进行搜索，那么这个字符串“周杰伦的歌曲”就会被存储在此变量中，
+     * 方便后续展示给用户查看，或者依据它再次发起类似的搜索操作等。
+     */
     String history;
+    /**
+     * 用于唯一标识每一条搜索历史记录的标识符，在数据库存储中充当主键的角色，
+     * 每一次用户的搜索操作记录在数据库里都会有一个与之对应的唯一整数值，通过这个值能够精准地定位、查询、修改或者删除对应的搜索历史记录，
+     * 通常该主键值由数据库按照自增等既定规则自动生成，以此保证每条搜索历史记录都能被准确区分和操作，便于数据库层面的高效管理。
+     */
     int id;
 
+    /**
+     * 获取存储的搜索历史信息（即用户曾经输入的搜索内容）的方法，外部代码通过调用此方法，
+     * 能够获取到一个字符串，该字符串就是对应的搜索历史记录的具体内容，在展示搜索历史列表、
+     * 根据历史记录再次发起搜索等业务场景中，这个方法提供了获取搜索历史内容的途径，方便进行相应的操作。
+     * @return 返回表示搜索历史内容的字符串。
+     */
     public String getHistory() {
         return history;
     }
 
+    /**
+     * 设置搜索历史信息的方法，当需要更新某条搜索历史记录的内容（比如最初记录有误、用户手动修改了历史记录等情况）时，
+     * 外部代码可以通过传入一个新的字符串作为参数，来更新当前SearchHistory对象中的搜索历史属性，
+     * 确保搜索历史信息的准确性和及时性，便于后续正确使用这些历史记录。
+     * @param history 要设置的表示搜索历史内容的字符串。
+     */
     public void setHistory(String history) {
         this.history = history;
     }
 
+    /**
+     * 获取当前搜索历史记录在数据库中的唯一标识（主键）的方法，外部代码调用此方法，
+     * 能够获取到一个整数值，该值可用于在数据库相关操作（如查询、更新、删除该搜索历史记录等）中准确地定位到对应的记录，
+     * 保证数据库操作的准确性和针对性，是对搜索历史记录进行数据库层面操作的关键入口之一。
+     * @return 返回表示搜索历史记录主键的整数值。
+     */
     public int getId() {
         return id;
     }
 
+    /**
+     * 设置当前搜索历史记录在数据库中的唯一标识（主键）的方法，不过一般情况下，
+     * 这个主键值由数据库自动管理和分配，很少会被外部代码直接调用修改，
+     * 只有在特定的业务场景下（如数据迁移过程中需要手动调整主键值、数据库记录出现异常需要修正主键等情况）才会使用，
+     * 通过传入一个合法的整数值来更新当前SearchHistory对象的主键信息。
+     * @param id 要设置的表示搜索历史记录主键的整数值。
+     */
     public void setId(int id) {
         this.id = id;
     }

app/src/main/java/com/example/musicplayer/entiy/SearchSong.java

@@ -6,24 +6,20 @@ import java.util.List;
  * <pre>
  *     author : 残渊
  *     time   : 2019/08/31
- *     desc   :
+ *     desc   : 这个类整体应该是用于表示搜索歌曲相关的信息结构，可能是用于接收和处理音乐搜索接口返回的数据等相关用途。
  * </pre>
  */
-
 public class SearchSong {
     /**
-     * code : 0
+     * 用于存储表示状态码之类的整数值，可能不同的值代表不同的请求响应状态，比如0可能表示成功等。
-     * data : {"keyword":"邓紫棋","priority":0,"qc":[],"semantic":{"curnum":0,"curpage":1,"list":[],"totalnum":0},"song":{"curnum":2,"curpage":1,"list":[{"albumid":7806097,"albummid":"001F3IM92zEXSX","albumname":"中国新说唱2019 第12期","albumname_hilight":"中国新说唱2019 第12期","alertid":23,"belongCD":0,"cdIdx":6,"chinesesinger":0,"docid":"1263425476867044852","grp":[],"interval":232,"isonly":0,"lyric":"","lyric_hilight":"","media_mid":"003XrSXL43XhhP","msgid":16,"newStatus":1,"nt":3078011703,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":0,"tryend":0,"trysize":960887},"pubtime":1567166403,"pure":0,"singer":[{"id":13948,"mid":"001fNHEf1SFEFN","name":"G.E.M. 邓紫棋","name_hilight":"G.E.M. <em>邓紫棋<\/em>"},{"id":3344622,"mid":"003MDz1629ej3X","name":"OBi","name_hilight":"OBi"},{"id":2626134,"mid":"001yBcHD4adsSA","name":"刘炫廷","name_hilight":"刘炫廷"},{"id":2085196,"mid":"001eBoUt4SiKgg","name":"Capper","name_hilight":"Capper"}],"size128":3728026,"size320":9319693,"sizeape":0,"sizeflac":0,"sizeogg":5221536,"songid":237274487,"songmid":"003XrSXL43XhhP","songname":"We Are Young (Live)","songname_hilight":"We Are Young (Live)","strMediaMid":"003XrSXL43XhhP","stream":1,"switch":17413891,"t":1,"tag":10,"type":0,"ver":0,"vid":""},{"albumid":1196826,"albummid":"003c616O2Zlswm","albumname":"新的心跳","albumname_hilight":"新的心跳","alertid":2,"belongCD":0,"cdIdx":4,"chinesesinger":0,"docid":"3872246129178486611","grp":[],"interval":245,"isonly":0,"lyric":"","lyric_hilight":"","media_mid":"001DI2Jj3Jqve9","msgid":16,"newStatus":2,"nt":2292267207,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":0,"tryend":0,"trysize":0},"pubtime":1446739200,"pure":0,"singer":[{"id":13948,"mid":"001fNHEf1SFEFN","name":"G.E.M. 邓紫棋","name_hilight":"G.E.M. <em>邓紫棋<\/em>"}],"size128":3929034,"size320":9822259,"sizeape":0,"sizeflac":29903656,"sizeogg":5405648,"songid":104913384,"songmid":"004dFFPd4JNv8q","songname":"来自天堂的魔鬼","songname_hilight":"来自天堂的魔鬼","strMediaMid":"001DI2Jj3Jqve9","stream":1,"switch":636675,"t":1,"tag":11,"type":0,"ver":0,"vid":"v001892io9b"}],"totalnum":416},"tab":0,"taglist":[],"totaltime":0,"zhida":{"chinesesinger":0,"type":0}}
-     * message :
-     * notice :
-     * subcode : 0
-     * time : 1567229228
-     * tips :
      */
-
     private int code;
+    /**
+     * 存储一个DataBean类型的对象，这个对象应该包含了更详细的搜索歌曲相关的数据内容。
+     */
     private DataBean data;
 
+    // 以下是获取和设置code属性的方法
     public int getCode() {
         return code;
     }
@@ -32,6 +28,7 @@ public class SearchSong {
         this.code = code;
     }
 
+    // 以下是获取和设置data属性的方法
     public DataBean getData() {
         return data;
     }
@@ -40,493 +37,681 @@ public class SearchSong {
         this.data = data;
     }
 
+    // 内部静态类DataBean，用于封装更细化的数据结构，是SearchSong类中数据部分的进一步细分。
     public static class DataBean {
         /**
-         * keyword : 邓紫棋
+         * 存储一个SongBean类型的对象，这个对象应该包含了歌曲具体信息相关的数据内容，比如歌曲列表、歌曲数量等。
-         * priority : 0
-         * qc : []
-         * semantic : {"curnum":0,"curpage":1,"list":[],"totalnum":0}
-         * song : {"curnum":2,"curpage":1,"list":[{"albumid":7806097,"albummid":"001F3IM92zEXSX","albumname":"中国新说唱2019 第12期","albumname_hilight":"中国新说唱2019 第12期","alertid":23,"belongCD":0,"cdIdx":6,"chinesesinger":0,"docid":"1263425476867044852","grp":[],"interval":232,"isonly":0,"lyric":"","lyric_hilight":"","media_mid":"003XrSXL43XhhP","msgid":16,"newStatus":1,"nt":3078011703,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":0,"tryend":0,"trysize":960887},"pubtime":1567166403,"pure":0,"singer":[{"id":13948,"mid":"001fNHEf1SFEFN","name":"G.E.M. 邓紫棋","name_hilight":"G.E.M. <em>邓紫棋<\/em>"},{"id":3344622,"mid":"003MDz1629ej3X","name":"OBi","name_hilight":"OBi"},{"id":2626134,"mid":"001yBcHD4adsSA","name":"刘炫廷","name_hilight":"刘炫廷"},{"id":2085196,"mid":"001eBoUt4SiKgg","name":"Capper","name_hilight":"Capper"}],"size128":3728026,"size320":9319693,"sizeape":0,"sizeflac":0,"sizeogg":5221536,"songid":237274487,"songmid":"003XrSXL43XhhP","songname":"We Are Young (Live)","songname_hilight":"We Are Young (Live)","strMediaMid":"003XrSXL43XhhP","stream":1,"switch":17413891,"t":1,"tag":10,"type":0,"ver":0,"vid":""},{"albumid":1196826,"albummid":"003c616O2Zlswm","albumname":"新的心跳","albumname_hilight":"新的心跳","alertid":2,"belongCD":0,"cdIdx":4,"chinesesinger":0,"docid":"3872246129178486611","grp":[],"interval":245,"isonly":0,"lyric":"","lyric_hilight":"","media_mid":"001DI2Jj3Jqve9","msgid":16,"newStatus":2,"nt":2292267207,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":0,"tryend":0,"trysize":0},"pubtime":1446739200,"pure":0,"singer":[{"id":13948,"mid":"001fNHEf1SFEFN","name":"G.E.M. 邓紫棋","name_hilight":"G.E.M. <em>邓紫棋<\/em>"}],"size128":3929034,"size320":9822259,"sizeape":0,"sizeflac":29903656,"sizeogg":5405648,"songid":104913384,"songmid":"004dFFPd4JNv8q","songname":"来自天堂的魔鬼","songname_hilight":"来自天堂的魔鬼","strMediaMid":"001DI2Jj3Jqve9","stream":1,"switch":636675,"t":1,"tag":11,"type":0,"ver":0,"vid":"v001892io9b"}],"totalnum":416}
-         * tab : 0
-         * taglist : []
-         * totaltime : 0
-         * zhida : {"chinesesinger":0,"type":0}
          */
-
-
         private SongBean song;
+
+        // 获取song属性的方法
         public SongBean getSong() {
             return song;
         }
 
+        // 设置song属性的方法
         public void setSong(SongBean song) {
             this.song = song;
         }
 
+        // 内部静态类SongBean，进一步细化歌曲相关的各种信息结构，比如歌曲列表情况、当前页、总数量等。
         public static class SongBean {
             /**
-             * curnum : 2
+             * 表示当前页的歌曲数量，用于分页展示歌曲信息等场景时体现当前页有几首歌曲。
-             * curpage : 1
-             * list : [{"albumid":7806097,"albummid":"001F3IM92zEXSX","albumname":"中国新说唱2019 第12期","albumname_hilight":"中国新说唱2019 第12期","alertid":23,"belongCD":0,"cdIdx":6,"chinesesinger":0,"docid":"1263425476867044852","grp":[],"interval":232,"isonly":0,"lyric":"","lyric_hilight":"","media_mid":"003XrSXL43XhhP","msgid":16,"newStatus":1,"nt":3078011703,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":0,"tryend":0,"trysize":960887},"pubtime":1567166403,"pure":0,"singer":[{"id":13948,"mid":"001fNHEf1SFEFN","name":"G.E.M. 邓紫棋","name_hilight":"G.E.M. <em>邓紫棋<\/em>"},{"id":3344622,"mid":"003MDz1629ej3X","name":"OBi","name_hilight":"OBi"},{"id":2626134,"mid":"001yBcHD4adsSA","name":"刘炫廷","name_hilight":"刘炫廷"},{"id":2085196,"mid":"001eBoUt4SiKgg","name":"Capper","name_hilight":"Capper"}],"size128":3728026,"size320":9319693,"sizeape":0,"sizeflac":0,"sizeogg":5221536,"songid":237274487,"songmid":"003XrSXL43XhhP","songname":"We Are Young (Live)","songname_hilight":"We Are Young (Live)","strMediaMid":"003XrSXL43XhhP","stream":1,"switch":17413891,"t":1,"tag":10,"type":0,"ver":0,"vid":""},{"albumid":1196826,"albummid":"003c616O2Zlswm","albumname":"新的心跳","albumname_hilight":"新的心跳","alertid":2,"belongCD":0,"cdIdx":4,"chinesesinger":0,"docid":"3872246129178486611","grp":[],"interval":245,"isonly":0,"lyric":"","lyric_hilight":"","media_mid":"001DI2Jj3Jqve9","msgid":16,"newStatus":2,"nt":2292267207,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":0,"tryend":0,"trysize":0},"pubtime":1446739200,"pure":0,"singer":[{"id":13948,"mid":"001fNHEf1SFEFN","name":"G.E.M. 邓紫棋","name_hilight":"G.E.M. <em>邓紫棋<\/em>"}],"size128":3929034,"size320":9822259,"sizeape":0,"sizeflac":29903656,"sizeogg":5405648,"songid":104913384,"songmid":"004dFFPd4JNv8q","songname":"来自天堂的魔鬼","songname_hilight":"来自天堂的魔鬼","strMediaMid":"001DI2Jj3Jqve9","stream":1,"switch":636675,"t":1,"tag":11,"type":0,"ver":0,"vid":"v001892io9b"}]
-             * totalnum : 416
              */
-
             private int curnum;
+            /**
+             * 表示当前是第几页，用于配合分页展示歌曲信息，方便知道当前所在的页面位置。
+             */
             private int curpage;
+            /**
+             * 表示总的歌曲数量，用于展示歌曲搜索结果整体的数量情况，方便分页等相关逻辑判断。
+             */
             private int totalnum;
+            /**
+             * 存储一个List<ListBean>类型的列表，里面每个ListBean对象应该包含了具体每首歌曲详细的各项信息。
+             */
             private List<ListBean> list;
 
+            // 获取当前页歌曲数量的方法
             public int getCurnum() {
                 return curnum;
             }
 
+            // 设置当前页歌曲数量的方法
             public void setCurnum(int curnum) {
                 this.curnum = curnum;
             }
 
+            // 获取当前页码的方法
             public int getCurpage() {
                 return curpage;
             }
 
+            // 设置当前页码的方法
             public void setCurpage(int curpage) {
                 this.curpage = curpage;
             }
 
+            // 获取总歌曲数量的方法
             public int getTotalnum() {
                 return totalnum;
             }
 
+            // 设置总歌曲数量的方法
             public void setTotalnum(int totalnum) {
                 this.totalnum = totalnum;
             }
 
+            // 获取歌曲列表信息的方法
             public List<ListBean> getList() {
                 return list;
             }
 
+            // 设置歌曲列表信息的方法
             public void setList(List<ListBean> list) {
                 this.list = list;
             }
 
+            // 内部静态类ListBean，用来封装每一首歌曲具体的详细信息，如专辑信息、歌手信息、歌曲时长等众多细节内容。
             public static class ListBean {
                 /**
-                 * albumid : 7806097
+                 * 专辑的唯一标识ID，用于区分不同的专辑，方便关联查询专辑的其他详细信息等。
-                 * albummid : 001F3IM92zEXSX
-                 * albumname : 中国新说唱2019 第12期
-                 * albumname_hilight : 中国新说唱2019 第12期
-                 * alertid : 23
-                 * belongCD : 0
-                 * cdIdx : 6
-                 * chinesesinger : 0
-                 * docid : 1263425476867044852
-                 * grp : []
-                 * interval : 232
-                 * isonly : 0
-                 * lyric :
-                 * lyric_hilight :
-                 * media_mid : 003XrSXL43XhhP
-                 * msgid : 16
-                 * newStatus : 1
-                 * nt : 3078011703
-                 * pay : {"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200}
-                 * preview : {"trybegin":0,"tryend":0,"trysize":960887}
-                 * pubtime : 1567166403
-                 * pure : 0
-                 * singer : [{"id":13948,"mid":"001fNHEf1SFEFN","name":"G.E.M. 邓紫棋","name_hilight":"G.E.M. <em>邓紫棋<\/em>"},{"id":3344622,"mid":"003MDz1629ej3X","name":"OBi","name_hilight":"OBi"},{"id":2626134,"mid":"001yBcHD4adsSA","name":"刘炫廷","name_hilight":"刘炫廷"},{"id":2085196,"mid":"001eBoUt4SiKgg","name":"Capper","name_hilight":"Capper"}]
-                 * size128 : 3728026
-                 * size320 : 9319693
-                 * sizeape : 0
-                 * sizeflac : 0
-                 * sizeogg : 5221536
-                 * songid : 237274487
-                 * songmid : 003XrSXL43XhhP
-                 * songname : We Are Young (Live)
-                 * songname_hilight : We Are Young (Live)
-                 * strMediaMid : 003XrSXL43XhhP
-                 * stream : 1
-                 * switch : 17413891
-                 * t : 1
-                 * tag : 10
-                 * type : 0
-                 * ver : 0
-                 * vid :
                  */
-
                 private int albumid;
+                /**
+                 * 专辑的中间标识之类的字符串，具体作用可能根据业务逻辑而定，也许是在某些接口交互中用于识别专辑的特定标识。
+                 */
                 private String albummid;
+                /**
+                 * 专辑名称，用于展示给用户看这是哪张专辑的歌曲。
+                 */
                 private String albumname;
+                /**
+                 * 专辑名称的高亮显示版本，可能用于在搜索结果展示等场景中突出显示关键词相关部分。
+                 */
                 private String albumname_hilight;
+                /**
+                 * 可能是某种提醒相关的标识，具体含义需结合业务场景确定，比如是否有新消息提醒等与这首歌相关的提示标识。
+                 */
                 private int alertid;
+                /**
+                 * 可能表示所属CD相关的编号之类，也许用于区分歌曲所在不同CD的情况，具体看业务逻辑中对于CD组织歌曲的设定。
+                 */
                 private int belongCD;
+                /**
+                 * CD内的索引序号，用于在一张CD中定位歌曲的顺序位置等。
+                 */
                 private int cdIdx;
+                /**
+                 * 可能表示是否是中文歌手相关的标识，0或1等不同值来区分，具体含义依赖业务规则。
+                 */
                 private int chinesesinger;
+                /**
+                 * 文档的唯一标识，可能用于关联歌曲相关的文档资料等，比如歌词文档等的关联查找。
+                 */
                 private String docid;
+                /**
+                 * 歌曲的间隔时长，可能是歌曲时长相关，或者歌曲之间的间隔时间等，具体看业务中对这个字段的定义。
+                 */
                 private int interval;
+                /**
+                 * 可能是表示是否唯一之类的标识，比如是否是独家歌曲等含义，具体由业务决定其具体代表意义。
+                 */
                 private int isonly;
+                /**
+                 * 歌曲的歌词内容，用于展示给用户查看歌曲对应的文字内容。
+                 */
                 private String lyric;
+                /**
+                 * 歌词的高亮显示版本，用于在歌词展示等场景中突出显示关键词等情况。
+                 */
                 private String lyric_hilight;
+                /**
+                 * 歌曲媒体相关的中间标识，可能用于媒体播放等环节的识别定位等作用。
+                 */
                 private String media_mid;
+                /**
+                 * 消息标识，也许用于区分不同消息类型等与歌曲关联的消息相关情况，具体看业务逻辑。
+                 */
                 private int msgid;
+                /**
+                 * 新的状态标识，比如歌曲是否有更新等情况用不同的值来表示，具体业务场景下有不同含义。
+                 */
                 private int newStatus;
+                /**
+                 * 可能是某种时间戳或者计数之类的长整型数值，具体作用要结合业务逻辑确定，比如歌曲发布时间戳等。
+                 */
                 private long nt;
+                /**
+                 * 支付相关的信息封装对象，包含了如是否付费、付费价格等各种支付相关的细节情况。
+                 */
+                private PayBean pay;
+                /**
+                 * 预览相关的信息封装对象，包含了如预览开始位置、结束位置、大小等预览相关的细节情况，可能用于试听等功能相关设定。
+                 */
+                private PreviewBean preview;
+                /**
+                 * 歌曲的发布时间，用于展示歌曲是什么时候发布上线的。
+                 */
                 private int pubtime;
+                /**
+                 * 可能表示是否纯净版之类的标识，比如是否是无广告、无其他多余元素的版本，具体含义看业务定义。
+                 */
                 private int pure;
+                /**
+                 * 存储一个List<SingerBean>类型的列表，里面每个SingerBean对象代表参与演唱这首歌曲的歌手相关信息。
+                 */
+                private List<SingerBean> singer;
+                /**
+                 * 歌曲128k版本的文件大小，用于判断下载等场景中文件大小相关情况。
+                 */
                 private int size128;
+                /**
+                 * 歌曲320k版本的文件大小，同样用于下载等相关场景中判断文件大小情况。
+                 */
                 private int size320;
+                /**
+                 * APE格式歌曲文件的大小，若支持APE格式的话用于相关文件大小的记录等情况。
+                 */
                 private int sizeape;
+                /**
+                 * FLAC格式歌曲文件的大小，用于FLAC格式相关文件大小的记录，方便下载等相关处理时知晓文件体积情况。
+                 */
                 private int sizeflac;
+                /**
+                 * OGG格式歌曲文件的大小，针对OGG格式记录其文件大小，在不同格式处理时有大小相关参考依据。
+                 */
                 private int sizeogg;
+                /**
+                 * 歌曲的唯一标识ID，用于区分不同歌曲，方便在各种业务操作中准确识别每首歌曲。
+                 */
                 private int songid;
+                /**
+                 * 歌曲的中间标识字符串，作用类似media_mid等，可能在不同业务环节用于识别歌曲的特定标识。
+                 */
                 private String songmid;
+                /**
+                 * 歌曲名称，展示给用户看这是哪首歌曲。
+                 */
                 private String songname;
+                /**
+                 * 歌曲名称的高亮显示版本，在搜索展示等场景突出显示关键词相关部分。
+                 */
                 private String songname_hilight;
+                /**
+                 * 字符串形式的媒体中间标识，和media_mid类似功能，具体使用看业务场景下的区分情况。
+                 */
                 private String strMediaMid;
+                /**
+                 * 可能表示是否能在线播放之类的标识，比如1表示可以播放，0表示不能等，具体看业务对这个字段的定义。
+                 */
                 private int stream;
+                /**
+                 * 可能是某种切换相关的标识，比如播放源切换等情况的标识，具体含义依赖业务场景设定。
+                 */
                 private int switchX;
+                /**
+                 * 可能是某种类型标识，比如歌曲风格类型等用不同值区分，具体含义按业务逻辑确定。
+                 */
                 private int t;
+                /**
+                 * 标签标识，也许用于给歌曲打不同标签分类等情况，不同值代表不同标签含义，由业务定义。
+                 */
                 private int tag;
+                /**
+                 * 歌曲类型标识，比如是原创、翻唱等类型区分，具体业务场景下有不同含义。
+                 */
                 private int type;
+                /**
+                 * 版本相关标识，比如歌曲的版本号等，用于区分不同版本的歌曲情况。
+                 */
                 private int ver;
-                private List<SingerBean> singer;
 
+                // 获取专辑ID的方法
                 public int getAlbumid() {
                     return albumid;
                 }
 
+                // 设置专辑ID的方法
                 public void setAlbumid(int albumid) {
                     this.albumid = albumid;
                 }
 
+                // 获取专辑中间标识的方法
                 public String getAlbummid() {
                     return albummid;
                 }
 
+                // 设置专辑中间标识的方法
                 public void setAlbummid(String albummid) {
                     this.albummid = albummid;
                 }
 
+                // 获取专辑名称的方法
                 public String getAlbumname() {
                     return albumname;
                 }
 
+                // 设置专辑名称的方法
                 public void setAlbumname(String albumname) {
                     this.albumname = albumname;
                 }
 
+                // 获取专辑名称高亮显示版本的方法
                 public String getAlbumname_hilight() {
                     return albumname_hilight;
                 }
 
+                // 设置专辑名称高亮显示版本的方法
                 public void setAlbumname_hilight(String albumname_hilight) {
                     this.albumname_hilight = albumname_hilight;
                 }
 
+                // 获取提醒标识的方法
                 public int getAlertid() {
                     return alertid;
                 }
 
+                // 设置提醒标识的方法
                 public void setAlertid(int alertid) {
                     this.alertid = alertid;
                 }
 
+                // 获取所属CD相关编号的方法
                 public int getBelongCD() {
                     return belongCD;
                 }
 
+                // 设置所属CD相关编号的方法
                 public void setBelongCD(int belongCD) {
                     this.belongCD = belongCD;
                 }
 
+                // 获取CD内索引序号的方法
                 public int getCdIdx() {
                     return cdIdx;
                 }
 
+                // 设置CD内索引序号的方法
                 public void setCdIdx(int cdIdx) {
                     this.cdIdx = cdIdx;
                 }
 
+                // 获取是否中文歌手标识的方法
                 public int getChinesesinger() {
                     return chinesesinger;
                 }
 
+                // 设置是否中文歌手标识的方法
                 public void setChinesesinger(int chinesesinger) {
                     this.chinesesinger = chinesesinger;
                 }
 
+                // 获取文档唯一标识的方法
                 public String getDocid() {
                     return docid;
                 }
 
+                // 设置文档唯一标识的方法
                 public void setDocid(String docid) {
                     this.docid = docid;
                 }
 
+                // 获取歌曲间隔时长的方法
                 public int getInterval() {
                     return interval;
                 }
 
+                // 设置歌曲间隔时长的方法
                 public void setInterval(int interval) {
                     this.interval = interval;
                 }
 
+                // 获取是否唯一标识的方法
                 public int getIsonly() {
                     return isonly;
                 }
 
+                // 设置是否唯一标识的方法
                 public void setIsonly(int isonly) {
                     this.isonly = isonly;
                 }
 
+                // 获取歌词内容的方法
                 public String getLyric() {
                     return lyric;
                 }
 
+                // 设置歌词内容的方法
                 public void setLyric(String lyric) {
                     this.lyric = lyric;
                 }
 
+                // 获取歌词高亮显示版本的方法
                 public String getLyric_hilight() {
                     return lyric_hilight;
                 }
 
+                // 设置歌词高亮显示版本的方法
                 public void setLyric_hilight(String lyric_hilight) {
                     this.lyric_hilight = lyric_hilight;
                 }
 
+                // 获取歌曲媒体中间标识的方法
                 public String getMedia_mid() {
                     return media_mid;
                 }
 
+                // 设置歌曲媒体中间标识的方法
                 public void setMedia_mid(String media_mid) {
                     this.media_mid = media_mid;
                 }
 
+                // 获取消息标识的方法
                 public int getMsgid() {
                     return msgid;
                 }
 
+                // 设置消息标识的方法
                 public void setMsgid(int msgid) {
                     this.msgid = msgid;
                 }
 
+                // 获取新状态标识的方法
                 public int getNewStatus() {
                     return newStatus;
                 }
 
+                // 设置新状态标识的方法
                 public void setNewStatus(int newStatus) {
                     this.newStatus = newStatus;
                 }
 
+                // 获取时间戳之类长整型数值的方法
                 public long getNt() {
                     return nt;
                 }
 
+                // 设置时间戳之类长整型数值的方法
                 public void setNt(long nt) {
                     this.nt = nt;
                 }
 
+                // 获取支付相关信息对象的方法
+                public PayBean getPay() {
+                    return pay;
+                }
+
+                // 设置支付相关信息对象的方法
+                public void setPay(PayBean pay) {
+                    this.pay = pay;
+                }
+
+                // 获取预览相关信息对象的方法
+                public PreviewBean getPreview() {
+                    return preview;
+                }
+
+                // 设置预览相关信息对象的方法
+                public void setPreview(PreviewBean preview) {
+                    this.preview = preview;
+                }
+
+                // 获取歌曲发布时间的方法
                 public int getPubtime() {
                     return pubtime;
                 }
 
+                // 设置歌曲发布时间的方法
                 public void setPubtime(int pubtime) {
                     this.pubtime = pubtime;
                 }
 
+                // 获取是否纯净版标识的方法
                 public int getPure() {
                     return pure;
                 }
 
+                // 设置是否纯净版标识的方法
                 public void setPure(int pure) {
                     this.pure = pure;
                 }
 
+                // 获取歌手信息列表的方法
+                public List<SingerBean> getSinger() {
+                    return singer;
+                }
+
+                // 设置歌手信息列表的方法
+                public void setSinger(List<SingerBean> singer) {
+                    this.singer = singer;
+                }
+
+                // 获取128k歌曲文件大小的方法
                 public int getSize128() {
                     return size128;
                 }
 
+                // 设置128k歌曲文件大小的方法
                 public void setSize128(int size128) {
                     this.size128 = size128;
                 }
 
+                // 获取320k歌曲文件大小的方法
                 public int getSize320() {
                     return size320;
                 }
 
+                // 设置320k歌曲文件大小的方法
                 public void setSize320(int size320) {
                     this.size320 = size320;
                 }
 
+                // 获取APE格式歌曲文件大小的方法
                 public int getSizeape() {
                     return sizeape;
                 }
 
+                // 设置APE格式歌曲文件大小的方法
                 public void setSizeape(int sizeape) {
                     this.sizeape = sizeape;
                 }
 
+                // 获取FLAC格式歌曲文件大小的方法
                 public int getSizeflac() {
                     return sizeflac;
-                }
+                    public void setSizeflac(int sizeflac) {
-
+                        // 设置FLAC格式歌曲文件大小的方法，将传入的参数赋值给当前对象的sizeflac属性，以便更新歌曲该格式文件大小信息
-                public void setSizeflac(int sizeflac) {
+                        this.sizeflac = sizeflac;
-                    this.sizeflac = sizeflac;
+                    }
-                }
-
-                public int getSizeogg() {
-                    return sizeogg;
-                }
-
-                public void setSizeogg(int sizeogg) {
-                    this.sizeogg = sizeogg;
-                }
-
-                public int getSongid() {
-                    return songid;
-                }
-
-                public void setSongid(int songid) {
-                    this.songid = songid;
-                }
-
-                public String getSongmid() {
-                    return songmid;
-                }
-
-                public void setSongmid(String songmid) {
-                    this.songmid = songmid;
-                }
-
-                public String getSongname() {
-                    return songname;
-                }
-
-                public void setSongname(String songname) {
-                    this.songname = songname;
-                }
-
-                public String getSongname_hilight() {
-                    return songname_hilight;
-                }
-
-                public void setSongname_hilight(String songname_hilight) {
-                    this.songname_hilight = songname_hilight;
-                }
-
-                public String getStrMediaMid() {
-                    return strMediaMid;
-                }
-
-                public void setStrMediaMid(String strMediaMid) {
-                    this.strMediaMid = strMediaMid;
-                }
 
-                public int getStream() {
+                    public int getSizeogg() {
-                    return stream;
+                        // 获取OGG格式歌曲文件大小的方法，用于在其他地方获取当前歌曲的OGG格式文件大小数值
-                }
+                        return sizeogg;
+                    }
 
-                public void setStream(int stream) {
+                    public void setSizeogg(int sizeogg) {
-                    this.stream = stream;
+                        // 设置OGG格式歌曲文件大小的方法，把传入的sizeogg参数赋值给当前对象对应的属性，实现文件大小信息更新
-                }
+                        this.sizeogg = sizeogg;
+                    }
 
-                public int getSwitchX() {
+                    public int getSongid() {
-                    return switchX;
+                        // 获取歌曲唯一标识ID的方法，方便在整个业务逻辑中通过这个ID来准确区分和操作不同的歌曲
-                }
+                        return songid;
+                    }
 
-                public void setSwitchX(int switchX) {
+                    public void setSongid(int songid) {
-                    this.switchX = switchX;
+                        // 设置歌曲唯一标识ID的方法，外部传入的songid参数会被赋给当前对象的songid属性，以此来确定歌曲的唯一标识
-                }
+                        this.songid = songid;
+                    }
 
-                public int getT() {
+                    public String getSongmid() {
-                    return t;
+                        // 获取歌曲中间标识字符串的方法，在涉及歌曲相关的特定业务操作（比如和某些接口交互等）中，可能会用到这个标识来识别歌曲
-                }
+                        return songmid;
+                    }
 
-                public void setT(int t) {
+                    public void setSongmid(String songmid) {
-                    this.t = t;
+                        // 设置歌曲中间标识字符串的方法，将传入的songmid参数赋值给当前对象对应的属性，更新歌曲的这个标识信息
-                }
+                        this.songmid = songmid;
+                    }
 
-                public int getTag() {
+                    public String getSongname() {
-                    return tag;
+                        // 获取歌曲名称的方法，用于展示给用户看具体是哪首歌曲，或者在一些业务处理中根据歌曲名称进行相关操作
-                }
+                        return songname;
+                    }
 
-                public void setTag(int tag) {
+                    public void setSongname(String songname) {
-                    this.tag = tag;
+                        // 设置歌曲名称的方法，通过传入的参数来更新当前对象的歌曲名称属性，改变歌曲对应的显示名称
-                }
+                        this.songname = songname;
+                    }
 
-                public int getType() {
+                    public String getSongname_hilight() {
-                    return type;
+                        // 获取歌曲名称高亮显示版本的方法，在搜索结果展示等需要突出显示关键词的场景下，获取这个高亮处理后的名称进行展示
-                }
+                        return songname_hilight;
+                    }
 
-                public void setType(int type) {
+                    public void setSongname_hilight(String songname_hilight) {
-                    this.type = type;
+                        // 设置歌曲名称高亮显示版本的方法，将传入的高亮名称参数赋值给对应的属性，更新歌曲名称的高亮显示内容
-                }
+                        this.songname_hilight = songname_hilight;
+                    }
 
-                public int getVer() {
+                    public String getStrMediaMid() {
-                    return ver;
+                        // 获取字符串形式的媒体中间标识的方法，和media_mid类似，可能在不同的业务环节用于歌曲媒体相关的识别等操作
-                }
+                        return strMediaMid;
+                    }
 
-                public void setVer(int ver) {
+                    public void setStrMediaMid(String strMediaMid) {
-                    this.ver = ver;
+                        // 设置字符串形式的媒体中间标识的方法，将传入的参数赋值给对应属性，更新这个媒体相关的标识信息
-                }
+                        this.strMediaMid = strMediaMid;
+                    }
 
+                    public int getStream() {
+                        // 获取可能表示是否能在线播放之类标识的方法，不同的值（比如1表示可以播放，0表示不能等）代表不同的播放状态，供业务逻辑判断使用
+                        return stream;
+                    }
 
-                public List<SingerBean> getSinger() {
+                    public void setStream(int stream) {
-                    return singer;
+                        // 设置是否能在线播放标识的方法，外部传入的stream参数会更新当前对象对应的属性，改变歌曲的播放状态标识
-                }
+                        this.stream = stream;
+                    }
 
-                public void setSinger(List<SingerBean> singer) {
+                    public int getSwitchX() {
-                    this.singer = singer;
+                        // 获取可能是某种切换相关标识的方法，比如涉及播放源切换等情况时，通过这个标识来判断是否需要切换以及切换的相关状态，具体含义依赖业务场景设定
-                }
+                        return switchX;
+                    }
 
+                    public void setSwitchX(int switchX) {
+                        // 设置切换相关标识的方法，将传入的switchX参数赋值给对应属性，更新歌曲的这个切换相关标识信息
+                        this.switchX = switchX;
+                    }
 
-                public static class SingerBean {
+                    public int getT() {
-                    /**
+                        // 获取可能是某种类型标识的方法，例如歌曲风格类型等也许会用不同值来区分，具体含义由业务逻辑确定，供业务处理时参考判断歌曲的相关类型情况
-                     * id : 13948
+                        return t;
-                     * mid : 001fNHEf1SFEFN
+                    }
-                     * name : G.E.M. 邓紫棋
-                     * name_hilight : G.E.M. <em>邓紫棋</em>
-                     */
 
-                    private int id;
+                    public void setT(int t) {
-                    private String mid;
+                        // 设置某种类型标识的方法，传入的t参数会更新当前对象对应的属性，改变这个类型标识的取值
-                    private String name;
+                        this.t = t;
-                    private String name_hilight;
+                    }
 
-                    public int getId() {
+                    public int getTag() {
-                        return id;
+                        // 获取标签标识的方法，在歌曲打不同标签分类等业务场景下，通过这个标识来知晓歌曲所属的标签类别，不同值代表不同标签含义
+                        return tag;
                     }
 
-                    public void setId(int id) {
+                    public void setTag(int tag) {
-                        this.id = id;
+                        // 设置标签标识的方法，外部传入的tag参数会赋值给对应属性，以此更新歌曲的标签分类标识
+                        this.tag = tag;
                     }
 
-                    public String getMid() {
+                    public int getType() {
-                        return mid;
+                        // 获取歌曲类型标识的方法，比如区分是原创、翻唱等不同类型的歌曲，业务中根据这个标识来进行相应的不同处理逻辑
+                        return type;
                     }
 
-                    public void setMid(String mid) {
+                    public void setType(int type) {
-                        this.mid = mid;
+                        // 设置歌曲类型标识的方法，将传入的type参数赋值给对应属性，改变歌曲的类型标识取值，更新其类型相关信息
+                        this.type = type;
                     }
 
-                    public String getName() {
+                    public int getVer() {
-                        return name;
+                        // 获取版本相关标识的方法，比如歌曲的版本号等，用于在业务处理中判断歌曲是否是不同版本，进而进行对应的版本相关操作
+                        return ver;
                     }
 
-                    public void setName(String name) {
+                    public void setVer(int ver) {
-                        this.name = name;
+                        // 设置版本相关标识的方法，传入的ver参数会更新当前对象的版本标识属性，改变歌曲对应的版本相关信息
+                        this.ver = ver;
                     }
 
-                    public String getName_hilight() {
+
-                        return name_hilight;
+                    public List<SingerBean> getSinger() {
+                        // 获取参与演唱这首歌曲的歌手信息列表的方法，方便在业务逻辑中获取所有参与演唱的歌手详细情况，比如展示歌手名字等操作
+                        return singer;
                     }
 
-                    public void setName_hilight(String name_hilight) {
+                    public void setSinger(List<SingerBean> singer) {
-                        this.name_hilight = name_hilight;
+                        // 设置参与演唱这首歌曲的歌手信息列表的方法，传入的歌手信息列表参数会替换当前对象保存的歌手列表，更新歌曲对应的歌手信息
+                        this.singer = singer;
                     }
-                }
-            }
-        }
-    }
 
 
-}
+                    public static class SingerBean {
+                        /**
+                         * id : 13948
+                         * mid : 001fNHEf1SFEFN
+                         * name : G.E.M. 邓紫棋
+                         * name_hilight : G.E.M. <em>邓紫棋</em>
+                         */
+
+                        // 歌手的唯一标识ID，用于区分不同的歌手个体，在整个业务系统中可以通过这个ID准确识别不同的歌手对象，比如关联查询歌手的其他详细资料等
+                        private int id;
+                        // 歌手的中间标识字符串，具体用途根据业务逻辑而定，可能在和某些音乐相关接口交互等场景下用于识别歌手的特定标识
+                        private String mid;
+                        // 歌手的名称，展示给用户看是谁演唱了这首歌曲，是最直观的歌手信息呈现内容
+                        private String name;
+                        // 歌手名称的高亮显示版本，在搜索展示等场景下，可用于突出显示关键词（比如在搜索某个歌手时突出显示匹配的部分）
+                        private String name_hilight;
+
+                        public int getId() {
+                            // 获取歌手唯一标识ID的方法，供业务逻辑中需要根据歌手ID进行相关操作（如查询、关联等）时使用
+                            return id;
+                        }
+
+                        public void setId(int id) {
+                            // 设置歌手唯一标识ID的方法，将传入的id参数赋值给当前对象的id属性，更新歌手的唯一标识信息
+                            this.id = id;
+                        }
+
+                        public String getMid() {
+                            // 获取歌手中间标识字符串的方法，方便在涉及特定业务环节（如接口调用中识别歌手等）使用这个标识进行相关操作
+                            return mid;
+                        }
+
+                        public void setMid(String mid) {
+                            // 设置歌手中间标识字符串的方法，把传入的mid参数赋值给对应属性，改变歌手的这个标识信息
+                            this.mid = mid;
+                        }
+
+                        public String getName() {
+                            // 获取歌手名称的方法，用于在各种界面展示等场景下向用户呈现演唱歌曲的歌手是谁
+                            return name;
+                        }
+
+                        public void setName(String name) {
+                            // 设置歌手名称的方法，传入的name参数会更新当前对象的name属性，改变歌手对应的显示名称
+                            this.name = name;
+                        }
+
+                        public String getName_hilight() {
+                            // 获取歌手名称高亮显示版本的方法，在需要突出显示歌手名称中关键词的场景下，获取这个高亮处理后的名称进行展示
+                            return name_hilight;
+                        }
+
+                        public void setName_hilight(String name_hilight) {
+                            // 设置歌手名称高亮显示版本的方法，将传入的高亮名称参数赋值给对应属性，更新歌手名称的高亮显示内容
+                            this.name_hilight = name_hilight;
+                        }
+                    }   

app/src/main/java/com/example/musicplayer/entiy/SingerImg.java

@@ -4,99 +4,111 @@ import java.util.List;
 
 /**
  * Created by 残渊 on 2018/10/26.
+ * 这个类整体应该是用于获取歌手相关图片信息的数据结构类，可能是接收从某个音乐服务端获取歌手图片等相关数据的载体。
  */
-
 public class SingerImg {
 
     /**
-     * result : {"artistCount":1,"artists":[{"id":840134,"name":"刘瑞琦","picUrl":"http://p1.music.126.net/qTDkcmWPMK3U54RNC0IgMw==/109951163288035254.jpg","alias":[],"albumSize":20,"picId":109951163288035254,"img1v1Url":"http://p1.music.126.net/a13xmSNqxMY5M_R1OFvPvA==/109951163288038157.jpg","accountId":3788031,"img1v1":109951163288038157,"mvSize":16,"followed":false,"trans":null}]}
+     * 存储一个ResultBean类型的对象，这个对象应该包含了查询歌手图片相关操作后的具体结果数据，比如包含歌手列表以及对应的各种图片链接等详细信息。
-     * code : 200
      */
-
     private ResultBean result;
+    /**
+     * 可能用于表示请求响应的状态码，例如200通常表示请求成功，不同的数值对应不同的请求处理结果情况。
+     */
     private int code;
 
+    // 获取result属性的方法，方便在外部获取包含详细结果信息的ResultBean对象。
     public ResultBean getResult() {
         return result;
     }
 
+    // 设置result属性的方法，外部可以传入ResultBean对象来更新当前SingerImg对象中保存的结果数据。
     public void setResult(ResultBean result) {
         this.result = result;
     }
 
+    // 获取code属性的方法，用于获取表示请求响应状态的状态码数值。
     public int getCode() {
         return code;
     }
 
+    // 设置code属性的方法，外部可传入状态码数值来更新当前对象保存的请求响应状态信息。
     public void setCode(int code) {
         this.code = code;
     }
 
+    // 内部静态类ResultBean，用于进一步细分和封装查询歌手图片结果中的详细数据结构。
     public static class ResultBean {
         /**
-         * artistCount : 1
+         * 表示获取到的歌手数量，方便知晓此次查询操作返回了几位歌手的相关图片等信息，便于后续业务逻辑中对歌手数量相关的判断处理。
-         * artists : [{"id":840134,"name":"刘瑞琦","picUrl":"http://p1.music.126.net/qTDkcmWPMK3U54RNC0IgMw==/109951163288035254.jpg","alias":[],"albumSize":20,"picId":109951163288035254,"img1v1Url":"http://p1.music.126.net/a13xmSNqxMY5M_R1OFvPvA==/109951163288038157.jpg","accountId":3788031,"img1v1":109951163288038157,"mvSize":16,"followed":false,"trans":null}]
          */
-
         private List<ArtistsBean> artists;
 
+        // 获取artists属性的方法，用于获取包含歌手详细信息的列表对象，以便进一步操作每个歌手的数据。
         public List<ArtistsBean> getArtists() {
             return artists;
         }
 
+        // 设置artists属性的方法，外部传入的包含歌手信息的列表会更新当前ResultBean对象中保存的歌手信息。
         public void setArtists(List<ArtistsBean> artists) {
             this.artists = artists;
         }
 
+        // 内部静态类ArtistsBean，用于详细封装每个歌手对应的各项具体信息，比如歌手ID、姓名、图片链接等。
         public static class ArtistsBean {
             /**
-             * id : 840134
+             * 歌手的唯一标识ID，用于区分不同的歌手个体，在整个音乐业务系统中可通过这个ID来准确查找、关联歌手的其他相关资料等。
-             * name : 刘瑞琦
-             * picUrl : http://p1.music.126.net/qTDkcmWPMK3U54RNC0IgMw==/109951163288035254.jpg
-             * alias : []
-             * albumSize : 20
-             * picId : 109951163288035254
-             * img1v1Url : http://p1.music.126.net/a13xmSNqxMY5M_R1OFvPvA==/109951163288038157.jpg
-             * accountId : 3788031
-             * img1v1 : 109951163288038157
-             * mvSize : 16
-             * followed : false
-             * trans : null
              */
-
             private int id;
+            /**
+             * 歌手的姓名，直观展示给用户看这位歌手是谁，也是识别歌手的重要信息之一。
+             */
             private String name;
+            /**
+             * 歌手的图片链接，通过这个链接可以获取到歌手对应的图片资源，比如用于在界面上展示歌手的形象照片等。
+             */
             private String picUrl;
+            /**
+             * 可能是歌手图片的另一种特定格式（比如统一规格尺寸等）的链接，用于在不同的展示场景下获取合适的歌手图片资源，具体作用依赖业务设定。
+             */
             private String img1v1Url;
 
+            // 获取歌手ID的方法，供外部业务逻辑中需要根据歌手ID进行查询、判断等操作时使用。
             public int getId() {
                 return id;
             }
 
+            // 设置歌手ID的方法，外部传入的歌手ID数值会更新当前对象保存的歌手唯一标识信息。
             public void setId(int id) {
                 this.id = id;
             }
 
+            // 获取歌手姓名的方法，方便在界面展示等场景下获取并呈现歌手的名字信息。
             public String getName() {
                 return name;
             }
 
+            // 设置歌手姓名的方法，传入的歌手姓名字符串会更新当前对象保存的歌手名称信息。
             public void setName(String name) {
                 this.name = name;
             }
 
+            // 获取歌手图片链接的方法，用于获取该歌手对应的原始图片资源链接，以便加载展示图片等操作。
             public String getPicUrl() {
                 return picUrl;
             }
 
+            // 设置歌手图片链接的方法，外部传入的图片链接字符串会更新当前对象保存的图片链接信息，改变对应的图片资源指向。
             public void setPicUrl(String picUrl) {
                 this.picUrl = picUrl;
             }
 
+            // 获取特定格式歌手图片链接的方法，用于获取符合特定要求（如特定尺寸等）的图片资源链接，供不同展示场景使用。
             public String getImg1v1Url() {
                 return img1v1Url;
             }
 
+            // 设置特定格式歌手图片链接的方法，传入的特定格式图片链接字符串会更新当前对象保存的对应链接信息。
             public void setImg1v1Url(String img1v1Url) {
                 this.img1v1Url = img1v1Url;
             }

app/src/main/java/com/example/musicplayer/entiy/Song.java

@@ -1,141 +1,183 @@
 package com.example.musicplayer.entiy;
 
 import org.litepal.crud.LitePalSupport;
-
 import java.io.Serializable;
 
 /**
  * Created by 残渊 on 2018/10/19.
+ * 这个类名为Song，代表歌曲相关的实体类，它继承自LitePalSupport类以便能方便地使用LitePal框架提供的数据库操作功能，
+ * 同时实现了Serializable接口，使得该类的对象可以在网络传输或者存储到本地文件等场景下进行序列化和反序列化操作，方便数据的持久化和传递。
  */
-
 public class Song extends LitePalSupport implements Serializable {
-    private static final long serialVersionUID=1L;
+    // 用于标识类的序列化版本号，在类结构发生变化（如新增、删除成员变量等情况）时，如果版本号不一致，在反序列化时可能会出现问题，这里初始化为1L。
+    private static final long serialVersionUID = 1L;
 
+    // 歌曲在数据库或业务逻辑中的唯一标识ID，通常用于区分不同的歌曲记录，比如在数据库操作中作为主键等用途。
     private long id;
 
-    private String songId; //歌曲id
+    // 歌曲自身的ID，用于唯一标识一首歌曲，可能是音乐平台分配的特定标识，方便在业务逻辑中通过这个ID来查找、操作对应的歌曲信息。
-    private String qqId;//专属本地音乐，本地音乐在qq音乐中的songId
+    private String songId;
-    private String mediaId;//播放id,下载需要用到
+    // 专属本地音乐对应的QQ音乐中的歌曲ID，用于和QQ音乐相关联，针对本地音乐在QQ音乐体系下的标识，便于进行一些跨平台或特定QQ音乐相关操作时使用。
-   private String singer; //歌手
+    private String qqId;
-    private long duration; //总时长
+    // 播放ID，在进行歌曲下载等操作时可能会用到，也许是用于向服务器请求播放资源或者下载资源时的一个关键标识。
-    private String songName; //歌曲名字
+    private String mediaId;
-    private String url;  //歌曲url
+    // 演唱这首歌曲的歌手名称，用于展示歌曲的演唱者信息给用户，也是区分不同歌曲的重要属性之一。
-    private long currentTime; //歌曲播放时长位置
+    private String singer;
-    private int position;//在音乐列表的位置
+    // 歌曲的总时长，通常以秒或者毫秒等时间单位来计量，方便在播放界面展示歌曲时长以及进行播放进度相关的计算等操作。
-    private String imgUrl; //歌曲照片
+    private long duration;
-    private boolean isOnline; //是否为网络歌曲
+    // 歌曲的名称，是展示给用户最直观的信息，用于识别具体是哪一首歌曲。
-    private int listType; //歌曲列表类别,0表示当前没有列表，即可能在播放网络歌曲
+    private String songName;
-    private boolean isDownload;//是否为下载的歌曲
+    // 歌曲的资源链接（URL），通过这个链接可以获取到歌曲的音频文件，用于播放或者下载等操作。
-
+    private String url;
-
+    // 歌曲当前播放到的时长位置，比如在播放过程中记录已经播放了多少时间，方便实现进度条展示、暂停续播等功能。
+    private long currentTime;
+    // 歌曲在音乐列表中的位置序号，用于在展示歌曲列表时确定歌曲的顺序，方便用户定位和操作列表中的歌曲。
+    private int position;
+    // 歌曲对应的照片（图片）链接，可通过这个链接获取到用于展示歌曲相关的图片资源，比如专辑封面、歌手写真等图片，增强展示效果。
+    private String imgUrl;
+    // 用于标识歌曲是否为网络歌曲，true表示是网络歌曲，需要通过网络获取资源进行播放；false表示可能是本地存储的歌曲等情况。
+    private boolean isOnline;
+    // 歌曲列表类别，0表示当前没有列表（可能意味着正在播放网络歌曲，未关联到具体的本地列表等情况），其他值可能对应不同类型的歌曲列表分类，具体含义由业务决定。
+    private int listType;
+    // 用于标识歌曲是否为已经下载到本地的歌曲，true表示已下载，可直接从本地读取资源进行播放；false表示未下载，可能需要从网络获取等情况。
+    private boolean isDownload;
+
+    // 获取歌曲自身ID的方法，供外部代码获取该歌曲对应的唯一标识字符串，方便业务逻辑中根据ID进行相关查询等操作。
     public String getSongId() {
         return songId;
     }
 
+    // 设置歌曲自身ID的方法，外部传入的歌曲ID字符串会更新当前Song对象中保存的对应标识信息，用于改变歌曲的唯一标识。
     public void setSongId(String songId) {
         this.songId = songId;
     }
 
+    // 获取专属本地音乐在QQ音乐中的歌曲ID的方法，方便在涉及QQ音乐相关操作或者关联本地与QQ音乐资源时获取对应的标识信息。
     public String getQqId() {
         return qqId;
     }
 
+    // 设置专属本地音乐在QQ音乐中的歌曲ID的方法，外部传入的QQ音乐ID字符串会更新当前对象保存的该标识信息。
     public void setQqId(String qqId) {
         this.qqId = qqId;
     }
 
+    // 获取播放ID的方法，在进行歌曲下载、播放资源请求等操作时，可通过这个方法获取对应的标识信息，传递给相关接口使用。
     public String getMediaId() {
         return mediaId;
     }
 
+    // 设置播放ID的方法，传入的播放ID字符串会更新当前Song对象中保存的播放标识，以便改变对应的播放相关标识信息。
     public void setMediaId(String mediaId) {
         this.mediaId = mediaId;
     }
 
+    // 获取歌手名称的方法，用于在界面展示、业务逻辑判断（比如根据歌手分类歌曲等）等场景下获取歌曲的演唱者信息。
     public String getSinger() {
         return singer;
     }
 
+    // 设置歌手名称的方法，外部传入的歌手名字符串会更新当前对象保存的歌手信息，比如歌曲信息更新后修改演唱者名字等情况。
     public void setSinger(String singer) {
         this.singer = singer;
     }
 
+    // 获取歌曲总时长的方法，在展示歌曲时长、计算播放进度占比等操作时可获取该时长数值进行相关处理。
     public long getDuration() {
         return duration;
     }
 
+    // 设置歌曲总时长的方法，传入的时长数值（通常以合适的时间单位计量）会更新当前Song对象保存的歌曲总时长信息，比如纠正时长错误等情况使用。
     public void setDuration(long duration) {
         this.duration = duration;
     }
 
+    // 获取歌曲名称的方法，方便在各种界面（如播放列表、搜索结果等）展示歌曲的具体名称，让用户知晓是哪首歌。
     public String getSongName() {
         return songName;
     }
 
+    // 设置歌曲名称的方法，传入的歌曲名字符串会更新当前对象保存的歌曲名称信息，比如歌曲重命名等业务场景下使用。
     public void setSongName(String songName) {
         this.songName = songName;
     }
 
+    // 获取歌曲资源链接（URL）的方法，在播放歌曲或者下载歌曲等操作时，通过这个方法获取对应的链接，传递给相关的播放、下载组件使用。
     public String getUrl() {
         return url;
     }
 
+    // 设置歌曲资源链接（URL）的方法，传入的新的URL字符串会更新当前Song对象保存的资源链接信息，比如更换歌曲播放源等情况使用。
     public void setUrl(String url) {
         this.url = url;
     }
 
+    // 获取歌曲当前播放时长位置的方法，用于展示播放进度、实现续播等功能时获取当前已经播放到的时间位置信息。
     public long getCurrentTime() {
         return currentTime;
     }
 
+    // 设置歌曲当前播放时长位置的方法，传入的时长数值会更新当前对象保存的当前播放时长信息，比如用户手动拖动进度条改变播放位置等情况使用。
     public void setCurrentTime(long currentTime) {
         this.currentTime = currentTime;
     }
 
+    // 获取歌曲在音乐列表中位置序号的方法，在展示列表、操作列表顺序等场景下获取歌曲对应的位置信息，方便进行相应处理。
     public int getPosition() {
         return position;
     }
 
+    // 设置歌曲在音乐列表中位置序号的方法，传入的位置序号数值会更新当前Song对象保存的列表位置信息，比如歌曲在列表中排序变动等情况使用。
     public void setPosition(int position) {
         this.position = position;
     }
 
+    // 获取歌曲照片（图片）链接的方法，在需要展示歌曲相关图片（如专辑封面等）时，通过这个方法获取对应的图片资源链接进行加载展示。
     public String getImgUrl() {
         return imgUrl;
     }
 
+    // 设置歌曲照片（图片）链接的方法，传入的新的图片链接字符串会更新当前Song对象保存的图片链接信息，比如更换图片资源等情况使用。
     public void setImgUrl(String imgUrl) {
         this.imgUrl = imgUrl;
     }
 
+    // 获取歌曲是否为网络歌曲标识的方法，返回true表示是网络歌曲，false表示不是，方便业务逻辑根据歌曲来源进行不同处理。
     public boolean isOnline() {
         return isOnline;
     }
 
+    // 设置歌曲是否为网络歌曲标识的方法，传入的布尔值会更新当前对象保存的网络歌曲标识信息，比如歌曲存储位置改变等情况使用。
     public void setOnline(boolean online) {
         isOnline = online;
     }
 
+    // 获取歌曲列表类别标识的方法，返回的整数值代表不同的歌曲列表分类情况（0有特定含义，其他值由业务定义），方便业务逻辑根据类别进行相关操作。
     public int getListType() {
         return listType;
     }
 
+    // 设置歌曲列表类别标识的方法，传入的整数值会更新当前Song对象保存的歌曲列表类别信息，比如切换歌曲所属列表类型等情况使用。
     public void setListType(int listType) {
         this.listType = listType;
     }
 
+    // 获取歌曲是否为已下载歌曲标识的方法，返回true表示已下载，false表示未下载，便于业务逻辑根据下载状态进行不同处理，比如本地播放还是网络获取等操作。
     public boolean isDownload() {
         return isDownload;
     }
 
+    // 设置歌曲是否为已下载歌曲标识的方法，传入的布尔值会更新当前对象保存的下载标识信息，比如歌曲下载完成或者删除本地文件后更新状态等情况使用。
     public void setDownload(boolean download) {
         isDownload = download;
     }
 
+    // 获取歌曲在数据库或业务逻辑中的唯一标识ID的方法，在数据库操作（如查询、更新、删除等）或者其他基于ID的业务处理时获取该数值进行相关操作。
     public long getId() {
         return id;
     }
 
+    // 重写toString方法，用于方便地将歌曲对象转换为字符串表示形式，通常在调试、日志记录等场景下可以直观地看到歌曲对象的各个属性信息内容。
     public String toString(){
         return "songName="+songName+",singer="+singer+",url="+url+",imgUrl="+imgUrl
                 +",duration="+duration+",currentTime="+currentTime+",position="+ position

app/src/main/java/com/example/musicplayer/entiy/SongLrc.java

@@ -1,7 +1,6 @@
 package com.example.musicplayer.entiy;
 
 import com.google.gson.annotations.SerializedName;
-
 import java.util.List;
 
 /**
@@ -10,35 +9,35 @@ import java.util.List;
  *     time   : 2019/09/04
  *     desc   : 歌词
  * </pre>
+ * 这个类整体用于表示歌曲歌词相关的信息结构，可能是从音乐服务端获取歌词数据后，在本地进行存储、展示等操作所使用的实体类。
  */
-
 public class SongLrc {
 
     /**
-     * code : 0
+     * 可能用于表示请求歌词相关操作的响应状态码，例如0可能表示获取歌词成功等，不同的值对应不同的请求处理结果情况。
-     * data : {"keyword":"说谎","lyric":{"curnum":1,"curpage":1,"list":[{"albumid":54250,"albummid":"004YodY33zsWTT","albumname":"感官/世界","albumname_hilight":"感官/世界","alertid":23,"belongCD":0,"cdIdx":6,"chinesesinger":0,"content":"说谎 (거짓말) (《杜拉拉升职记》电视剧插曲|《针尖上的天使》电影主题曲) - 林宥嘉 (Yoga Lin)\\n 词：施人诚\\n 曲：李双飞\\n 是有过几个不错对象\\n 说起来并不寂寞孤单\\n 可能我浪荡让人家不安\\n 才会结果都阵亡\\n 我没有什么阴影魔障\\n 你千万不要放在心上\\n 我又不脆弱何况那算什么伤\\n 反正爱情不就都这样\\n 我没有说谎我何必说谎\\n 你懂我的我对你从来就不会假装\\n 我哪有说谎\\n 请别以为你有多难忘\\n 笑是真的不是我逞强\\n 我好久没来这间餐厅\\n 没想到已经换了装潢\\n 角落那窗口闻的到玫瑰花香\\n 被你一说是有些印象\\n 我没有说谎我何必说谎\\n 你知道的我缺点之一就是很健忘\\n 我哪有说谎\\n 是很感谢今晚的相伴\\n 但我竟然有些不习惯\\n 我没有说谎我何必说谎\\n 爱一个人没爱到难道就会怎么样\\n 别说我说谎\\n 人生已经如此的艰难\\n 有些事情就不要拆穿\\n 我没有说谎是爱情说谎\\n 它带你来骗我说\\n 渴望的有 可能有希望\\n 我没有说谎\\n 祝你做个幸福的新娘\\n 我的心事请你就遗忘","docid":"12084758858355992521","download_url":"http://soso.music.qq.com/fcgi-bin/fcg_download_lrc.q?song=说谎&singer=林宥嘉&down=1&songid=638596&docid=12084758858355992521","interval":266,"isonly":0,"lyric":" 我哪有<em>说谎<\/em>\\n 请别以为你有多难忘\\n 笑是真的不是我逞强\\n","media_mid":"000W95Fk3lAVxV","msgid":14,"nt":3842743252,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":73557,"tryend":104291,"trysize":0},"pubtime":1256832000,"pure":0,"singer":[{"id":11606,"mid":"001f0VyZ1hmWZ1","name":"林宥嘉","name_hilight":"林宥嘉"}],"size128":4264898,"size320":10652912,"sizeape":27291116,"sizeflac":28067207,"sizeogg":5800490,"songid":638596,"songmid":"000W95Fk3lAVxV","songname":"说谎","songname_hilight":"<em>说谎<\/em>","strMediaMid":"000W95Fk3lAVxV","stream":1,"switch":636675,"t":1,"tag":11,"type":0,"ver":0,"vid":""}],"totalnum":246},"priority":0,"qc":[],"tab":7,"taglist":[],"totaltime":0,"zhida":{"chinesesinger":0,"type":0}}
-     * message :
-     * notice :
-     * subcode : 0
-     * time : 1567575160
-     * tips :
      */
-
     private int code;
+    /**
+     * 存储一个DataBean类型的对象，这个对象包含了更详细的歌词相关数据，比如歌词具体内容、关联的歌曲信息等内容。
+     */
     private DataBean data;
 
+    // 获取code属性的方法，方便外部获取表示歌词请求响应状态的状态码数值。
     public int getCode() {
         return code;
     }
 
+    // 设置code属性的方法，外部可传入状态码数值来更新当前对象保存的请求响应状态信息，比如在重新请求歌词等情况时更新状态码。
     public void setCode(int code) {
         this.code = code;
     }
 
+    // 获取data属性的方法，用于获取包含详细歌词相关数据的DataBean对象，以便进一步操作歌词的具体信息。
     public DataBean getData() {
         return data;
     }
 
+    // 设置data属性的方法，外部传入的DataBean对象会更新当前SongLrc对象中保存的歌词详细结果数据，比如获取到新的歌词信息后进行替换。
     public void setData(DataBean data) {
         this.data = data;
     }
@@ -46,300 +45,472 @@ public class SongLrc {
 
     public static class DataBean {
         /**
-         * keyword : 说谎
+         * 搜索歌词时使用的关键词，可能是歌曲名、歌手名等用于定位查找对应歌词的关键信息，方便在歌词库中检索到准确的歌词内容。
-         * lyric : {"curnum":1,"curpage":1,"list":[{"albumid":54250,"albummid":"004YodY33zsWTT","albumname":"感官/世界","albumname_hilight":"感官/世界","alertid":23,"belongCD":0,"cdIdx":6,"chinesesinger":0,"content":"说谎 (거짓말) (《杜拉拉升职记》电视剧插曲|《针尖上的天使》电影主题曲) - 林宥嘉 (Yoga Lin)\\n 词：施人诚\\n 曲：李双飞\\n 是有过几个不错对象\\n 说起来并不寂寞孤单\\n 可能我浪荡让人家不安\\n 才会结果都阵亡\\n 我没有什么阴影魔障\\n 你千万不要放在心上\\n 我又不脆弱何况那算什么伤\\n 反正爱情不就都这样\\n 我没有说谎我何必说谎\\n 你懂我的我对你从来就不会假装\\n 我哪有说谎\\n 请别以为你有多难忘\\n 笑是真的不是我逞强\\n 我好久没来这间餐厅\\n 没想到已经换了装潢\\n 角落那窗口闻的到玫瑰花香\\n 被你一说是有些印象\\n 我没有说谎我何必说谎\\n 你知道的我缺点之一就是很健忘\\n 我哪有说谎\\n 是很感谢今晚的相伴\\n 但我竟然有些不习惯\\n 我没有说谎我何必说谎\\n 爱一个人没爱到难道就会怎么样\\n 别说我说谎\\n 人生已经如此的艰难\\n 有些事情就不要拆穿\\n 我没有说谎是爱情说谎\\n 它带你来骗我说\\n 渴望的有 可能有希望\\n 我没有说谎\\n 祝你做个幸福的新娘\\n 我的心事请你就遗忘","docid":"12084758858355992521","download_url":"http://soso.music.qq.com/fcgi-bin/fcg_download_lrc.q?song=说谎&singer=林宥嘉&down=1&songid=638596&docid=12084758858355992521","interval":266,"isonly":0,"lyric":" 我哪有<em>说谎<\/em>\\n 请别以为你有多难忘\\n 笑是真的不是我逞强\\n","media_mid":"000W95Fk3lAVxV","msgid":14,"nt":3842743252,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":73557,"tryend":104291,"trysize":0},"pubtime":1256832000,"pure":0,"singer":[{"id":11606,"mid":"001f0VyZ1hmWZ1","name":"林宥嘉","name_hilight":"林宥嘉"}],"size128":4264898,"size320":10652912,"sizeape":27291116,"sizeflac":28067207,"sizeogg":5800490,"songid":638596,"songmid":"000W95Fk3lAVxV","songname":"说谎","songname_hilight":"<em>说谎<\/em>","strMediaMid":"000W95Fk3lAVxV","stream":1,"switch":636675,"t":1,"tag":11,"type":0,"ver":0,"vid":""}],"totalnum":246}
+         */
-         * priority : 0
+        private String keyword;
-         * qc : []
+        /**
-         * tab : 7
+         * 存储一个LyricBean类型的对象，这个对象封装了歌词主体相关的详细信息，比如歌词的分页情况、具体的歌词文本内容等。
-         * taglist : []
-         * totaltime : 0
-         * zhida : {"chinesesinger":0,"type":0}
          */
-
         private LyricBean lyric;
+        /**
+         * 可能用于表示歌词数据的优先级等情况，具体含义需结合业务场景确定，比如优先展示高优先级的歌词版本等情况会用到这个属性。
+         */
+        private int priority;
+        /**
+         * 不清楚具体用途的列表，从变量名看可能是和歌词质量检查等相关的内容，具体作用要根据业务逻辑来确定。
+         */
+        private List<?> qc;
+        /**
+         * 不清楚具体含义的属性，也许是用于和歌词展示页面的标签页等相关的标识，具体业务场景下有其对应的作用。
+         */
+        private int tab;
+        /**
+         * 不清楚具体用途的列表，可能是歌词相关的标签列表等，具体含义由业务中对歌词分类、标记等操作的逻辑来决定。
+         */
+        private List<?> taglist;
+        /**
+         * 不清楚具体含义的时间相关属性，也许是和歌词获取、处理过程总共花费的时间等相关，具体要结合业务逻辑看其作用。
+         */
+        private int totaltime;
+        /**
+         * 包含了一些和歌词相关的辅助信息的对象，比如是否是中文歌手、歌词类型等相关的细节情况，方便更全面地了解歌词的一些属性特点。
+         */
+        private ZhidaBean zhida;
+
+        // 获取keyword属性的方法，用于获取歌词搜索时的关键词信息，在一些搜索相关的业务逻辑中可能会用到。
+        public String getKeyword() {
+            return keyword;
+        }
 
+        // 设置keyword属性的方法，外部传入的关键词字符串会更新当前DataBean对象保存的关键词信息，比如更换搜索歌词的关键词等情况使用。
+        public void setKeyword(String keyword) {
+            this.keyword = keyword;
+        }
+
+        // 获取lyric属性的方法，用于获取包含歌词详细信息的LyricBean对象，进而操作歌词的具体文本、分页等内容。
         public LyricBean getLyric() {
             return lyric;
         }
 
+        // 设置lyric属性的方法，传入的LyricBean对象会更新当前DataBean对象中保存的歌词主体信息，比如获取到新的歌词版本后进行替换。
         public void setLyric(LyricBean lyric) {
             this.lyric = lyric;
         }
 
+        // 获取priority属性的方法，在涉及歌词优先级相关的业务逻辑（如展示顺序等）时，可获取这个优先级数值进行判断处理。
+        public int getPriority() {
+            return priority;
+        }
+
+        // 设置priority属性的方法，外部传入的优先级数值会更新当前对象保存的歌词优先级信息，比如调整歌词的展示优先级等情况使用。
+        public void setPriority(int priority) {
+            this.priority = priority;
+        }
+
+        // 获取qc属性的方法，虽然不清楚具体用途，但在涉及到这个列表相关的业务逻辑（如果是质量检查相关，可能是获取检查结果等情况）时可获取该列表。
+        public List<?> getQc() {
+            return qc;
+        }
+
+        // 设置qc属性的方法，外部传入的对应类型的列表会更新当前DataBean对象保存的这个属性信息，比如更新质量检查结果列表等情况使用。
+        public void setQc(List<?> qc) {
+            this.qc = qc;
+        }
+
+        // 获取tab属性的方法，在涉及和歌词展示页面的标签页等相关操作（如果是用于标识标签页的话，可能是获取当前所在标签页等情况）时获取该属性值。
+        public int getTab() {
+            return tab;
+        }
+
+        // 设置tab属性的方法，传入的整数值会更新当前对象保存的这个和标签页相关的标识信息，比如切换歌词展示的标签页等情况使用。
+        public void setTab(int tab) {
+            this.tab = tab;
+        }
+
+        // 获取taglist属性的方法，在涉及歌词分类、标记相关的业务逻辑（如果是歌词标签列表，可能是获取所有标签进行展示、筛选等操作）时获取该列表。
+        public List<?> getTaglist() {
+            return taglist;
+        }
+
+        // 设置taglist属性的方法，外部传入的对应类型的列表会更新当前DataBean对象保存的歌词标签列表信息，比如更新歌词的分类标签等情况使用。
+        public void setTaglist(List<?> taglist) {
+            this.taglist = taglist;
+        }
+
+        // 获取totaltime属性的方法，在涉及歌词获取、处理过程总时间相关的业务逻辑（比如统计性能、展示耗时等情况）时获取该时间数值。
+        public int getTotaltime() {
+            return totaltime;
+        }
+
+        // 设置totaltime属性的方法，传入的时间数值会更新当前对象保存的这个总时间信息，比如重新记录歌词处理耗时等情况使用。
+        public void setTotaltime(int totaltime) {
+            this.totaltime = totaltime;
+        }
+
+        // 获取zhida属性的方法，用于获取包含歌词相关辅助信息的ZhidaBean对象，以便进一步了解歌词的一些属性特点，辅助业务处理。
+        public ZhidaBean getZhida() {
+            return zhida;
+        }
+
+        // 设置zhida属性的方法，传入的ZhidaBean对象会更新当前DataBean对象中保存的歌词辅助信息，比如更新歌词的类型等相关属性情况使用。
+        public void setZhida(ZhidaBean zhida) {
+            this.zhida = zhida;
+        }
+
         public static class LyricBean {
             /**
-             * curnum : 1
+             * 表示当前页的歌词数量（可能是按照某种分页规则划分歌词后的当前页数量情况），方便在歌词分页展示等场景下知晓当前页有多少条歌词相关内容。
-             * curpage : 1
-             * list : [{"albumid":54250,"albummid":"004YodY33zsWTT","albumname":"感官/世界","albumname_hilight":"感官/世界","alertid":23,"belongCD":0,"cdIdx":6,"chinesesinger":0,"content":"说谎 (거짓말) (《杜拉拉升职记》电视剧插曲|《针尖上的天使》电影主题曲) - 林宥嘉 (Yoga Lin)\\n 词：施人诚\\n 曲：李双飞\\n 是有过几个不错对象\\n 说起来并不寂寞孤单\\n 可能我浪荡让人家不安\\n 才会结果都阵亡\\n 我没有什么阴影魔障\\n 你千万不要放在心上\\n 我又不脆弱何况那算什么伤\\n 反正爱情不就都这样\\n 我没有说谎我何必说谎\\n 你懂我的我对你从来就不会假装\\n 我哪有说谎\\n 请别以为你有多难忘\\n 笑是真的不是我逞强\\n 我好久没来这间餐厅\\n 没想到已经换了装潢\\n 角落那窗口闻的到玫瑰花香\\n 被你一说是有些印象\\n 我没有说谎我何必说谎\\n 你知道的我缺点之一就是很健忘\\n 我哪有说谎\\n 是很感谢今晚的相伴\\n 但我竟然有些不习惯\\n 我没有说谎我何必说谎\\n 爱一个人没爱到难道就会怎么样\\n 别说我说谎\\n 人生已经如此的艰难\\n 有些事情就不要拆穿\\n 我没有说谎是爱情说谎\\n 它带你来骗我说\\n 渴望的有 可能有希望\\n 我没有说谎\\n 祝你做个幸福的新娘\\n 我的心事请你就遗忘","docid":"12084758858355992521","download_url":"http://soso.music.qq.com/fcgi-bin/fcg_download_lrc.q?song=说谎&singer=林宥嘉&down=1&songid=638596&docid=12084758858355992521","interval":266,"isonly":0,"lyric":" 我哪有<em>说谎<\/em>\\n 请别以为你有多难忘\\n 笑是真的不是我逞强\\n","media_mid":"000W95Fk3lAVxV","msgid":14,"nt":3842743252,"pay":{"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200},"preview":{"trybegin":73557,"tryend":104291,"trysize":0},"pubtime":1256832000,"pure":0,"singer":[{"id":11606,"mid":"001f0VyZ1hmWZ1","name":"林宥嘉","name_hilight":"林宥嘉"}],"size128":4264898,"size320":10652912,"sizeape":27291116,"sizeflac":28067207,"sizeogg":5800490,"songid":638596,"songmid":"000W95Fk3lAVxV","songname":"说谎","songname_hilight":"<em>说谎<\/em>","strMediaMid":"000W95Fk3lAVxV","stream":1,"switch":636675,"t":1,"tag":11,"type":0,"ver":0,"vid":""}]
-             * totalnum : 246
              */
-
             private int curnum;
+            /**
+             * 表示当前是第几页歌词，用于配合歌词分页展示，方便用户知道当前看到的是歌词的哪一页内容，以及进行翻页等操作时的判断依据。
+             */
             private int curpage;
+            /**
+             * 表示总的歌词数量，用于展示歌词整体的篇幅情况，方便结合当前页信息进行分页相关的逻辑处理，比如计算总页数等操作。
+             */
             private int totalnum;
+            /**
+             * 存储一个List<ListBean>类型的列表，里面每个ListBean对象包含了具体每一段歌词以及其关联的歌曲等详细信息，比如歌词文本、所属歌曲专辑信息等。
+             */
             private List<ListBean> list;
 
+            // 获取当前页歌词数量的方法，供在歌词分页展示等业务逻辑中获取当前页歌词数量信息，进行相关处理（如判断是否显示翻页按钮等）。
             public int getCurnum() {
                 return curnum;
             }
 
+            // 设置当前页歌词数量的方法，外部传入的当前页歌词数量数值会更新当前LyricBean对象保存的对应信息，比如重新分页后更新数量情况。
             public void setCurnum(int curnum) {
                 this.curnum = curnum;
             }
 
+            // 获取当前页码的方法，用于在歌词展示界面等场景下获取当前所在的页码信息，方便用户知晓位置以及进行翻页操作等。
             public int getCurpage() {
                 return curpage;
             }
 
+            // 设置当前页码的方法，传入的页码数值会更新当前对象保存的当前页码信息，比如用户手动翻页后更新当前页码显示等情况使用。
             public void setCurpage(int curpage) {
                 this.curpage = curpage;
             }
 
+            // 获取总歌词数量的方法，在涉及歌词整体篇幅展示、分页计算等业务逻辑中获取总数量信息进行相应处理。
             public int getTotalnum() {
                 return totalnum;
             }
 
+            // 设置总歌词数量的方法，外部传入的总歌词数量数值会更新当前LyricBean对象保存的对应信息，比如歌词有新增或删减后更新总数量。
             public void setTotalnum(int totalnum) {
                 this.totalnum = totalnum;
             }
 
+            // 获取歌词列表信息的方法，用于获取包含具体每段歌词详细信息的列表对象，以便进一步操作每段歌词的具体数据，如展示歌词文本等。
             public List<ListBean> getList() {
                 return list;
             }
 
+            // 设置歌词列表信息的方法，传入的包含歌词详细信息的列表会更新当前LyricBean对象中保存的歌词列表内容，比如获取到新的歌词分段信息后替换。
             public void setList(List<ListBean> list) {
                 this.list = list;
             }
 
             public static class ListBean {
                 /**
-                 * albumid : 54250
+                 * 可能表示是否是中文歌手相关的标识，0或1等不同值来区分，具体含义依赖业务规则，用于判断歌曲演唱者相关语言属性情况，和歌词可能有一定关联（比如中文歌词对应中文歌手等情况的判断）。
-                 * albummid : 004YodY33zsWTT
-                 * albumname : 感官/世界
-                 * albumname_hilight : 感官/世界
-                 * alertid : 23
-                 * belongCD : 0
-                 * cdIdx : 6
-                 * chinesesinger : 0
-                 * content : 说谎 (거짓말) (《杜拉拉升职记》电视剧插曲|《针尖上的天使》电影主题曲) - 林宥嘉 (Yoga Lin)\n 词：施人诚\n 曲：李双飞\n 是有过几个不错对象\n 说起来并不寂寞孤单\n 可能我浪荡让人家不安\n 才会结果都阵亡\n 我没有什么阴影魔障\n 你千万不要放在心上\n 我又不脆弱何况那算什么伤\n 反正爱情不就都这样\n 我没有说谎我何必说谎\n 你懂我的我对你从来就不会假装\n 我哪有说谎\n 请别以为你有多难忘\n 笑是真的不是我逞强\n 我好久没来这间餐厅\n 没想到已经换了装潢\n 角落那窗口闻的到玫瑰花香\n 被你一说是有些印象\n 我没有说谎我何必说谎\n 你知道的我缺点之一就是很健忘\n 我哪有说谎\n 是很感谢今晚的相伴\n 但我竟然有些不习惯\n 我没有说谎我何必说谎\n 爱一个人没爱到难道就会怎么样\n 别说我说谎\n 人生已经如此的艰难\n 有些事情就不要拆穿\n 我没有说谎是爱情说谎\n 它带你来骗我说\n 渴望的有 可能有希望\n 我没有说谎\n 祝你做个幸福的新娘\n 我的心事请你就遗忘
-                 * docid : 12084758858355992521
-                 * download_url : http://soso.music.qq.com/fcgi-bin/fcg_download_lrc.q?song=说谎&singer=林宥嘉&down=1&songid=638596&docid=12084758858355992521
-                 * interval : 266
-                 * isonly : 0
-                 * lyric :  我哪有<em>说谎</em>\n 请别以为你有多难忘\n 笑是真的不是我逞强\n
-                 * media_mid : 000W95Fk3lAVxV
-                 * msgid : 14
-                 * nt : 3842743252
-                 * pay : {"payalbum":0,"payalbumprice":0,"paydownload":1,"payinfo":1,"payplay":0,"paytrackmouth":1,"paytrackprice":200}
-                 * preview : {"trybegin":73557,"tryend":104291,"trysize":0}
-                 * pubtime : 1256832000
-                 * pure : 0
-                 * singer : [{"id":11606,"mid":"001f0VyZ1hmWZ1","name":"林宥嘉","name_hilight":"林宥嘉"}]
-                 * size128 : 4264898
-                 * size320 : 10652912
-                 * sizeape : 27291116
-                 * sizeflac : 28067207
-                 * sizeogg : 5800490
-                 * songid : 638596
-                 * songmid : 000W95Fk3lAVxV
-                 * songname : 说谎
-                 * songname_hilight : <em>说谎</em>
-                 * strMediaMid : 000W95Fk3lAVxV
-                 * stream : 1
-                 * switch : 636675
-                 * t : 1
-                 * tag : 11
-                 * type : 0
-                 * ver : 0
-                 * vid :
                  */
                 private int chinesesinger;
+                /**
+                 * 歌词的具体内容文本，包含了整首歌完整的歌词文本或者按照一定规则划分后的一段歌词内容，是展示给用户看的核心信息。
+                 */
                 private String content;
+                /**
+                 * 可能表示歌词段落之间的间隔等相关时长信息（具体含义需结合业务确定，也许是用于歌词滚动展示时的时间间隔等情况），方便在歌词展示相关处理中使用。
+                 */
                 private int interval;
+                /**
+                 * 歌曲的发布时间，用于展示歌曲是什么时候发布上线的，和歌词关联起来可以知道这首歌词对应的歌曲的发布历史情况。
+                 */
                 private int pubtime;
+                /**
+                 * OGG格式歌曲文件的大小，针对OGG格式记录其文件大小，虽然主要是歌曲文件相关属性，但在这里可能是和歌词关联的歌曲整体信息的一部分，比如用于统计资源大小等情况。
+                 */
                 private int sizeogg;
+                /**
+                 * 歌曲的唯一标识ID，用于区分不同歌曲，方便在各种业务操作中准确识别每首歌曲，也便于将歌词准确对应到具体的歌曲上。
+                 */
                 private int songid;
+                /**
+                 * 歌曲的中间标识字符串，作用类似歌曲的其他标识，可能在不同业务环节用于识别歌曲的特定标识，在歌词与歌曲关联等操作中会用到。
+                 */
                 private String songmid;
+                /**
+                 * 歌曲名称，展示给用户看这是哪首歌曲，同时也是将歌词和对应的歌曲进行关联的重要标识信息之一。
+                 */
                 private String songname;
+                /**
+                 * 可能是某种切换相关的标识，比如播放源切换等情况的标识，不过在歌词相关这里具体含义依赖业务场景设定，也许和歌词展示时切换不同版本等情况有关。
+                 */
                 @SerializedName("switch")
                 private int switchX;
+                /**
+                 * 可能是某种类型标识，比如歌曲风格类型等用不同值区分，具体含义按业务逻辑确定，在歌词关联的歌曲整体属性中作为一种分类标识存在。
+                 */
                 private int t;
+                /**
+                 * 标签标识，也许用于给歌曲打不同标签分类等情况，不同值代表不同标签含义，由业务定义，在歌词关联的歌曲属性里用于分类等操作。
+                 */
                 private int tag;
+                /**
+                 * 歌曲类型标识，比如是原创、翻唱等类型区分，具体业务场景下有不同含义，也是歌词所对应歌曲的一种属性体现。
+                 */
                 private int type;
+                /**
+                 * 版本相关标识，比如歌曲的版本号等，用于区分不同版本的歌曲情况，在歌词对应不同版本歌曲时可通过这个标识来区分。
+                 */
                 private int ver;
+                /**
+                 * 可能是歌曲视频相关的标识（比如歌曲对应的MV等视频的标识），虽然主要和视频相关，但在这里作为歌曲整体信息一部分与歌词相关联，具体含义看业务逻辑。
+                 */
                 private String vid;
+                /**
+                 * 存储一个List<SingerBean>类型的列表，里面每个SingerBean对象代表参与演唱这首歌曲的歌手相关信息，用于明确歌词对应的歌曲是由哪些歌手演唱的。
+                 */
                 private List<SingerBean> singer;
 
-
+                // 获取是否是中文歌手标识的方法，在涉及根据歌手语言属性判断歌词相关情况（如筛选中文歌词等）的业务逻辑中获取该标识值进行判断处理。
                 public int getChinesesinger() {
                     return chinesesinger;
                 }
 
+                // 设置是否是中文歌手标识的方法，外部传入的标识数值会更新当前对象保存的这个和歌手语言属性相关的标识信息，比如歌曲演唱者变更等情况使用。
                 public void setChinesesinger(int chinesesinger) {
                     this.chinesesinger = chinesesinger;
                 }
 
+                // 获取歌词具体内容的方法，用于在歌词展示界面等场景下获取并展示具体的歌词文本内容给用户查看。
                 public String getContent() {
                     return content;
                 }
 
+                // 设置歌词具体内容的方法，传入的歌词文本字符串会更新当前对象保存的歌词内容信息，比如歌词有修改、更新版本后替换文本内容。
                 public void setContent(String content) {
                     this.content = content;
                 }
 
-
+                // 获取歌词间隔时长相关信息的方法，在歌词滚动展示等涉及时间间隔处理的业务逻辑中获取该时长数值进行相应操作。
                 public int getInterval() {
                     return interval;
                 }
 
+                // 设置歌词间隔时长相关信息的方法，外部传入的时长数值会更新当前对象保存的这个间隔时长信息，比如调整歌词滚动间隔等情况使用。
                 public void setInterval(int interval) {
                     this.interval = interval;
                 }
 
-
+                // 获取歌曲发布时间的方法，在展示歌词对应歌曲的发布历史等情况时获取该时间数值进行展示等操作。
                 public int getPubtime() {
                     return pubtime;
                 }
 
+                // 设置歌曲发布时间的方法，传入的发布时间数值会更新当前对象保存的歌曲发布时间信息，比如歌曲信息更新后修改发布时间等情况使用。
                 public void setPubtime(int pubtime) {
                     this.pubtime = pubtime;
                 }
 
-
+                // 获取OGG格式歌曲文件大小的方法，在涉及歌曲资源大小统计等和歌词关联的歌曲整体信息处理时获取该文件大小数值进行相关操作。
                 public int getSizeogg() {
                     return sizeogg;
                 }
 
+                // 设置OGG格式歌曲文件大小的方法，外部传入的文件大小数值会更新当前对象保存的这个文件大小信息，比如歌曲文件格式转换后更新大小情况。
                 public void setSizeogg(int sizeogg) {
                     this.sizeogg = sizeogg;
                 }
 
+                // 获取歌曲唯一标识ID的方法，在将歌词准确对应到具体歌曲、根据歌曲ID进行歌词相关业务操作（如查询、更新等）时获取该ID数值进行处理。
                 public int getSongid() {
                     return songid;
                 }
 
+                // 设置歌曲唯一标识ID的方法，传入的歌曲ID数值会更新当前对象保存的歌曲唯一标识信息，比如歌曲数据更新后修改ID等情况使用。
                 public void setSongid(int songid) {
                     this.songid = songid;
                 }
                 
+                // 获取歌曲中间标识字符串的方法，在涉及歌曲相关的特定业务操作（比如和某些接口交互、查询歌曲详细信息等）中，
+// 可能会用到这个标识来准确识别歌曲，方便外部代码获取该标识用于相关业务逻辑处理。
                 public String getSongmid() {
                     return songmid;
                 }
 
+                // 设置歌曲中间标识字符串的方法，外部传入的songmid参数会更新当前对象保存的歌曲中间标识信息，
+// 例如在从服务端获取到新的歌曲标识数据后，可通过此方法进行设置，以保持数据的准确性和一致性。
                 public void setSongmid(String songmid) {
                     this.songmid = songmid;
                 }
 
+                // 获取歌曲名称的方法，用于在界面上展示给用户看具体是哪首歌曲，或者在一些业务处理中（如歌词关联、播放记录统计等）
+// 根据歌曲名称进行相关操作时，获取该名称信息。
                 public String getSongname() {
                     return songname;
                 }
 
+                // 设置歌曲名称的方法，传入的songname参数会替换当前对象中保存的歌曲名称，比如歌曲重命名或者从外部数据源更新歌曲名称时使用。
                 public void setSongname(String songname) {
                     this.songname = songname;
                 }
 
+                // 获取可能是某种切换相关标识的方法，比如涉及播放源切换、歌词展示版本切换等情况时，
+// 通过这个标识来判断是否需要切换以及切换的相关状态，具体含义依赖业务场景设定，外部可获取该标识进行相应逻辑判断。
                 public int getSwitchX() {
                     return switchX;
                 }
 
+                // 设置切换相关标识的方法，将传入的switchX参数赋值给对应属性，更新歌曲（或相关业务逻辑中涉及的）这个切换相关标识信息，
+// 例如在发生需要更新切换状态的业务场景时调用此方法来改变标识值。
                 public void setSwitchX(int switchX) {
                     this.switchX = switchX;
                 }
 
+                // 获取可能是某种类型标识的方法，例如歌曲风格类型、歌词类型等也许会用不同值来区分，具体含义按业务逻辑确定，
+// 在业务处理中可根据这个标识来进行相应的不同处理逻辑，外部代码可获取该标识进行相关判断操作。
                 public int getT() {
                     return t;
                 }
 
+                // 设置某种类型标识的方法，传入的t参数会更新当前对象对应的属性，改变这个类型标识的取值，
+// 例如在歌曲类型变更或者根据业务规则重新设定类型标识时使用此方法来更新数据。
                 public void setT(int t) {
                     this.t = t;
                 }
 
+                // 获取标签标识的方法，在歌曲打不同标签分类（如热门、经典等）、歌词按标签筛选等业务场景下，
+// 通过这个标识来知晓歌曲（或与之关联的歌词等）所属的标签类别，不同值代表不同标签含义，外部可据此进行分类相关操作。
                 public int getTag() {
                     return tag;
                 }
 
+                // 设置标签标识的方法，外部传入的tag参数会赋值给对应属性，以此更新歌曲（及相关业务元素）的标签分类标识，
+// 比如后台管理端对歌曲标签进行重新编辑后，通过此方法将新标签同步到对象中。
                 public void setTag(int tag) {
                     this.tag = tag;
                 }
 
+                // 获取歌曲类型标识的方法，比如区分是原创、翻唱、伴奏等不同类型的歌曲，业务中根据这个标识来进行相应的不同处理逻辑，
+// 例如在播放列表展示、推荐算法中会依据歌曲类型进行不同的展示和推荐策略，外部可获取此标识用于相关业务逻辑判断。
                 public int getType() {
                     return type;
                 }
 
+                // 设置歌曲类型标识的方法，将传入的type参数赋值给对应属性，改变歌曲的类型标识取值，更新其类型相关信息，
+// 比如歌曲的创作属性发生变化后，通过此方法来更新类型标识以反映实际情况。
                 public void setType(int type) {
                     this.type = type;
                 }
 
+                // 获取版本相关标识的方法，比如歌曲的版本号、歌词的版本号等，用于在业务处理中判断歌曲（或歌词等）是否是不同版本，
+// 进而进行对应的版本相关操作，例如版本更新提示、不同版本切换等，外部可获取该标识来做相应处理。
                 public int getVer() {
                     return ver;
                 }
 
+                // 设置版本相关标识的方法，传入的ver参数会更新当前对象的版本标识属性，改变歌曲（或相关业务元素）对应的版本相关信息，
+// 比如在检测到有新版本发布后，调用此方法将版本标识更新为最新值。
                 public void setVer(int ver) {
                     this.ver = ver;
                 }
 
+                // 获取可能是歌曲视频相关的标识（比如歌曲对应的MV等视频的标识，或者用于关联视频资源的标识等）的方法，
+// 虽然主要和视频相关，但在这里作为歌曲整体信息一部分与歌词等相关联，具体含义看业务逻辑，外部可获取该标识做进一步操作。
                 public String getVid() {
                     return vid;
                 }
 
+                // 设置歌曲视频相关标识的方法，传入的vid参数会更新当前对象保存的这个视频相关标识信息，
+// 例如在视频资源链接变更或者新关联了视频资源后，通过此方法来更新对应的标识值。
                 public void setVid(String vid) {
                     this.vid = vid;
                 }
 
+                // 获取参与演唱这首歌曲的歌手信息列表的方法，方便在业务逻辑中获取所有参与演唱的歌手详细情况，
+// 比如展示歌手名字、根据歌手信息进行关联推荐等操作，外部可获取该列表来处理歌手相关业务逻辑。
                 public List<SingerBean> getSinger() {
                     return singer;
                 }
 
+                // 设置参与演唱这首歌曲的歌手信息列表的方法，传入的歌手信息列表参数会替换当前对象保存的歌手列表，
+// 例如在歌曲的演唱者信息发生变化（新增、删减歌手等情况）时，通过此方法来更新歌手相关数据。
                 public void setSinger(List<SingerBean> singer) {
                     this.singer = singer;
                 }
 
+                // 内部静态类SingerBean，用于详细封装每个歌手对应的各项具体信息，方便对歌手个体的信息进行管理和操作。
                 public static class SingerBean {
                     /**
-                     * id : 11606
+                     * 歌手的唯一标识ID，用于区分不同的歌手个体，在整个业务系统中可以通过这个ID准确查找、关联歌手的其他相关资料（如专辑、代表作等），
-                     * mid : 001f0VyZ1hmWZ1
+                     * 比如在数据库查询、数据关联等操作中作为关键的识别依据。
-                     * name : 林宥嘉
-                     * name_hilight : 林宥嘉
                      */
-
                     private int id;
+                    /**
+                     * 歌手的中间标识字符串，具体用途根据业务逻辑而定，可能在和某些音乐相关接口交互、查询歌手特定信息等场景下用于识别歌手的特定标识，
+                     * 起到辅助准确区分不同歌手的作用。
+                     */
                     private String mid;
+                    /**
+                     * 歌手的名称，直观展示给用户看是谁演唱了这首歌曲，是最直观的歌手信息呈现内容，也常用于各种展示界面、搜索筛选等业务操作中。
+                     */
                     private String name;
+                    /**
+                     * 歌手名称的高亮显示版本，在搜索展示、歌词中突出显示歌手名字等场景下，可用于突出显示关键词（比如在搜索某个歌手时突出显示匹配的部分），
+                     * 增强展示效果，方便用户快速定位关注的歌手信息。
+                     */
                     private String name_hilight;
 
+                    // 获取歌手唯一标识ID的方法，供业务逻辑中需要根据歌手ID进行相关操作（如查询、关联、判断等）时使用，外部可获取该ID进行相应处理。
                     public int getId() {
                         return id;
                     }
 
+                    // 设置歌手唯一标识ID的方法，将传入的id参数赋值给当前对象的id属性，更新歌手的唯一标识信息，
+                    // 例如在从数据源同步歌手最新ID或者修改歌手ID时调用此方法进行更新操作。
                     public void setId(int id) {
                         this.id = id;
                     }
 
+                    // 获取歌手中间标识字符串的方法，方便在涉及特定业务环节（如接口调用中识别歌手、与外部系统交互歌手数据等）使用这个标识进行相关操作，
+                    // 外部可获取该标识用于相应的业务逻辑处理。
                     public String getMid() {
                         return mid;
                     }
 
+                    // 设置歌手中间标识字符串的方法，把传入的mid参数赋值给对应属性，改变歌手的这个标识信息，
+                    // 比如在获取到新的歌手中间标识数据后，通过此方法来更新保存的值。
                     public void setMid(String mid) {
                         this.mid = mid;
                     }
 
+                    // 获取歌手名称的方法，用于在各种界面展示（如播放界面、歌手列表等）、业务逻辑判断（比如根据歌手分类歌曲、歌词关联歌手等）等场景下获取歌手的名字信息，
+                    // 外部可获取该名称进行展示或相关处理。
                     public String getName() {
                         return name;
                     }
 
+                    // 设置歌手名称的方法，传入的name参数会更新当前对象的name属性，改变歌手对应的显示名称，
+                    // 例如歌手改名或者从数据源同步最新名称时使用此方法进行更新。
                     public void setName(String name) {
                         this.name = name;
                     }
 
+                    // 获取歌手名称高亮显示版本的方法，在需要突出显示歌手名称中关键词的场景下（如搜索结果高亮显示、歌词中突出歌手名等），
+                    // 获取这个高亮处理后的名称进行展示，外部可获取该高亮名称用于相应的展示需求。
                     public String getName_hilight() {
                         return name_hilight;
                     }
 
+                    // 设置歌手名称高亮显示版本的方法，将传入的高亮名称参数赋值给对应属性，更新歌手名称的高亮显示内容，
+                    // 比如在更新了高亮显示规则或者从数据源获取到新的高亮名称数据后，通过此方法来更新保存的值。
                     public void setName_hilight(String name_hilight) {
                         this.name_hilight = name_hilight;
                     }
                 }
-            }
-        }
-    }
-}

app/src/main/java/com/example/musicplayer/event/AlbumCollectionEvent.java

@@ -1,12 +1,26 @@
 package com.example.musicplayer.event;
 
+// 该类的文档注释，提供了类的作者、创建时间和类的基本描述信息
 /**
  * <pre>
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 收藏专辑事件
+ * 
+ *     该类表示一个与收藏专辑相关的事件。
+ *     它可以用于在音乐播放器应用中，当用户执行收藏专辑操作时，触发相关的业务逻辑。
+ *     例如，通知界面更新收藏状态，或者与后端服务器进行数据同步，告知服务器用户已收藏了某张专辑。
+ *     该类目前是一个空类，可能会在后续开发中添加相关属性和方法，
+ *     以携带收藏事件的具体信息，如收藏的专辑ID、收藏的时间等。
  * </pre>
  */
-
+// 定义一个名为 AlbumCollectionEvent 的公共类
 public class AlbumCollectionEvent {
+    // 目前该类为空，没有任何成员变量和方法，可在后续开发中添加。
+    // 例如，可能会添加以下成员变量：
+    // private int albumId; 用于存储收藏的专辑的唯一标识符
+    // private Date collectionTime; 用于存储用户收藏该专辑的时间
+    // 可能会添加以下方法：
+    // public void notifyUI() { } 用于通知用户界面更新收藏状态
+    // public void syncWithServer() { } 用于将收藏信息同步到服务器
 }

app/src/main/java/com/example/musicplayer/event/DownloadEvent.java

@@ -1,5 +1,6 @@
 package com.example.musicplayer.event;
 
+// 导入 DownloadInfo 类，因为 DownloadEvent 类中使用了该类
 import com.example.musicplayer.entiy.DownloadInfo;
 
 /**
@@ -7,41 +8,60 @@ import com.example.musicplayer.entiy.DownloadInfo;
  *     author : 残渊
  *     time   : 2019/09/16
  *     desc   :
+ * 
+ *     这个类是一个下载事件类，用于表示音乐播放器应用中的下载相关事件。
+ *     它可以存储下载的状态信息，下载信息对象，以及在列表中的位置信息。
+ *     可以在下载开始、下载中、下载完成、下载失败等不同阶段创建不同的 DownloadEvent 对象，
+ *     并将其传递给其他组件，以实现下载事件的通知和处理。
  * </pre>
  */
-
 public class DownloadEvent {
-    private int downloadStatus;//下载的状态
+    // 存储下载的状态，可用于表示下载是否开始、正在进行、完成、失败等不同状态
+    private int downloadStatus;
+    // 存储下载信息，如文件大小、下载速度、已下载量等
     private DownloadInfo downloadInfo;
+    // 存储在下载列表或队列中的位置，方便进行位置相关的操作，比如更新 UI 中的下载进度条位置
     private int position;
 
 
+    // 构造函数，仅接收下载状态作为参数
     public DownloadEvent(int status){
+        // 将传入的状态存储到 downloadStatus 成员变量中
         downloadStatus = status;
     }
+    // 构造函数，接收下载状态和 DownloadInfo 对象作为参数
     public DownloadEvent(int status, DownloadInfo downloadInfo){
+        // 将传入的状态存储到 downloadStatus 成员变量中
         downloadStatus = status;
+        // 将传入的 DownloadInfo 对象存储到 downloadInfo 成员变量中
         this.downloadInfo = downloadInfo;
     }
 
+    // 构造函数，接收下载状态和位置作为参数
     public DownloadEvent(int status,int position){
+        // 将传入的状态存储到 downloadStatus 成员变量中
         downloadStatus = status;
+        // 将传入的位置存储到 position 成员变量中
         this.position = position;
     }
 
+    // 获取位置的方法
     public int getPosition() {
         return position;
     }
 
+    // 设置位置的方法
     public void setPosition(int position) {
         this.position = position;
     }
 
 
+    // 获取下载状态的方法
     public int getDownloadStatus() {
         return downloadStatus;
     }
 
+    // 获取下载信息的方法
     public DownloadInfo getDownloadInfo() {
         return downloadInfo;
     }

app/src/main/java/com/example/musicplayer/event/OnlineSongChangeEvent.java

@@ -5,8 +5,16 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 网络歌曲切换事件
+ * 
+ *     该类表示一个网络歌曲切换的事件类。
+ *     当用户在音乐播放器中切换网络歌曲时，可创建该类的对象，用于触发相应的事件处理逻辑。
+ *     例如，可以通知用户界面更新歌曲信息，如歌曲名称、歌手、专辑封面等，
+ *     也可以通知音频播放组件切换播放的歌曲源，
+ *     或者通知后台服务记录用户的播放历史和歌曲切换行为。
+ *     目前该类为空，后续可根据需求添加成员变量和方法。
  * </pre>
  */
-
 public class OnlineSongChangeEvent {
+    // 目前该类为空，可在后续开发中添加成员变量和方法。
+
 }

app/src/main/java/com/example/musicplayer/event/OnlineSongErrorEvent.java

@@ -5,8 +5,15 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/20
  *     desc   : 网络歌曲错误
+ * 
+ *     这个类是一个事件类，用于表示在音乐播放器中播放网络歌曲时出现的错误事件。
+ *     当网络歌曲播放过程中发生错误，例如网络连接中断、歌曲资源不存在、服务器错误等情况时，
+ *     可以创建该类的对象，以触发相应的错误处理逻辑。
+ *     可能会被用来通知用户界面显示错误消息，记录错误日志，
+ *     或者尝试重新连接网络或获取歌曲资源等操作。
+ *     目前该类为空，后续可以根据具体的错误处理需求添加成员变量和方法。
  * </pre>
  */
-
 public class OnlineSongErrorEvent {
+    // 目前该类为空，可在后续开发中添加成员变量和方法。
 }

app/src/main/java/com/example/musicplayer/event/SongAlbumEvent.java

@@ -5,8 +5,15 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 播放专辑歌曲事件
+ * 
+ *     该类用于表示在音乐播放器中播放专辑歌曲时的事件。
+ *     当用户选择播放专辑中的歌曲时，可以创建该类的对象，以触发相应的播放事件处理逻辑。
+ *     它可能会被用来通知用户界面更新播放界面，例如显示当前播放的歌曲信息、专辑封面等，
+ *     也可以通知音频播放组件开始播放专辑歌曲，
+ *     或者与后台服务交互，记录播放历史、更新用户偏好等。
+ *     目前该类为空，后续可根据需要添加成员变量和方法。
  * </pre>
  */
-
 public class SongAlbumEvent {
+    // 目前该类为空，可在后续开发中添加成员变量和方法。
 }

app/src/main/java/com/example/musicplayer/event/SongCollectionEvent.java

@@ -5,15 +5,25 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 收藏歌曲事件
+ * 
+ *     该类用于表示在音乐播放器中收藏歌曲的事件。
+ *     当用户对一首歌曲进行收藏操作时，可创建该类的对象。
+ *     它可以存储歌曲的收藏状态，并提供方法来获取和设置该状态。
+ *     该类可用于触发与歌曲收藏相关的业务逻辑，如更新用户界面显示，
+ *     或者将收藏状态同步到服务器或本地存储中。
  * </pre>
  */
-
 public class SongCollectionEvent {
+    // 存储歌曲的收藏状态，true 表示已收藏，false 表示未收藏
     private boolean isLove;
+
+    // 构造函数，接收一个布尔值表示收藏状态
     public SongCollectionEvent(boolean isLove){
+        // 将传入的收藏状态存储到 isLove 成员变量中
         this.isLove = isLove;
     }
 
+    // 获取歌曲的收藏状态的方法
     public boolean isLove() {
         return isLove;
     }

app/src/main/java/com/example/musicplayer/event/SongDownloadedEvent.java

@@ -5,8 +5,16 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/09/18
  *     desc   : 已下载歌曲改变的消息
+ * 
+ *     该类表示已下载歌曲发生改变的事件。
+ *     当音乐播放器中的已下载歌曲列表发生变化时，比如新增了一首已下载歌曲，
+ *     或者删除了一首已下载歌曲，可创建该类的对象，以触发相应的事件处理逻辑。
+ *     此事件可以用于通知用户界面更新已下载歌曲列表的显示，
+ *     也可以通知其他相关组件，如数据库管理器更新存储信息，
+ *     或者通知播放列表管理器更新可播放歌曲列表。
+ *     目前该类为空，后续可根据需求添加成员变量和方法。
  * </pre>
  */
-
 public class SongDownloadedEvent {
+    // 该类目前为空，后续可根据具体的需求添加成员变量和方法。
 }

app/src/main/java/com/example/musicplayer/event/SongHistoryEvent.java

@@ -5,8 +5,15 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 最近播放歌曲事件
+ * 
+ *     该类表示一个最近播放歌曲的事件。
+ *     当用户播放一首歌曲时，可创建该类的对象，用于触发最近播放歌曲的相关事件处理逻辑。
+ *     可以利用此事件来更新用户界面，显示最近播放歌曲列表，
+ *     或者通知存储服务更新最近播放歌曲的存储信息，
+ *     还可以用来向用户推荐与最近播放歌曲相似的歌曲等。
+ *     目前该类为空，后续可根据需求添加成员变量和方法。
  * </pre>
  */
-
 public class SongHistoryEvent {
+    // 目前该类为空，后续可根据具体需求添加成员变量和方法。
 }

app/src/main/java/com/example/musicplayer/event/SongListNumEvent.java

@@ -5,19 +5,30 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/09/20
  *     desc   : 歌曲列表数量变化消息
+ * 
+ *     该类用于表示歌曲列表数量发生变化的事件。
+ *     当歌曲列表中的歌曲数量增加或减少时，可以创建该类的对象，
+ *     并将该对象传递给相关组件，以触发相应的处理逻辑。
+ *     其中的 "type" 成员变量可用于表示歌曲列表数量变化的类型，
+ *     例如，正数表示增加，负数表示减少，不同的绝对值可能表示不同的操作量。
+ *     该类提供了获取和设置 "type" 成员变量的方法，方便其他组件操作。
  * </pre>
  */
-
 public class SongListNumEvent {
+    // 存储歌曲列表数量变化的类型，可用于表示数量的增减及变化量
     private int type;
+
+    // 构造函数，接收一个整数表示歌曲列表数量变化的类型，并将其存储在 type 变量中
     public SongListNumEvent(int type){
         this.type = type;
     }
 
+    // 获取歌曲列表数量变化类型的方法
     public int getType() {
         return type;
     }
 
+    // 设置歌曲列表数量变化类型的方法
     public void setType(int type) {
         this.type = type;
     }

app/src/main/java/com/example/musicplayer/event/SongLocalEvent.java

@@ -5,8 +5,16 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 本地歌曲改变事件
+ * 
+ *     该类用于表示本地歌曲发生改变的事件。
+ *     当用户对本地歌曲库进行操作，如添加、删除或修改本地歌曲时，
+ *     可以创建该类的对象，以触发相应的事件处理逻辑。
+ *     它可用于通知用户界面更新本地歌曲列表的显示，
+ *     或者通知文件管理系统更新存储信息，
+ *     也可以用于通知播放列表管理器更新可播放歌曲列表。
+ *     目前该类为空，后续可根据需求添加成员变量和方法。
  * </pre>
  */
-
 public class SongLocalEvent {
+    // 目前该类为空，后续可根据具体需求添加成员变量和方法。
 }

app/src/main/java/com/example/musicplayer/event/SongLocalSizeChangeEvent.java

@@ -5,8 +5,15 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 导入本地音乐事件
+ * 
+ *     该类表示一个导入本地音乐的事件。
+ *     当用户将本地音乐文件导入到音乐播放器中时，可创建该类的对象，
+ *     用于触发相关的事件处理逻辑。它可以用来通知用户界面更新音乐列表，
+ *     也可以通知存储系统更新本地音乐存储信息，
+ *     或者通知后台服务进行导入后的后续处理，例如索引构建或信息更新等。
+ *     目前该类为空，后续可根据需要添加成员变量和方法。
  * </pre>
  */
-
 public class SongLocalSizeChangeEvent {
+    // 该类目前为空，可在后续开发中添加成员变量和方法。
 }

app/src/main/java/com/example/musicplayer/event/SongStatusEvent.java

@@ -5,16 +5,27 @@ package com.example.musicplayer.event;
  *     author : 残渊
  *     time   : 2019/07/19
  *     desc   : 歌曲播放事件
+ * 
+ *     该类用于表示歌曲播放过程中的事件，主要是歌曲的播放状态。
+ *     当歌曲的播放状态发生变化时，例如开始播放、暂停播放、停止播放等，可以创建该类的对象。
+ *     它包含一个 songStatus 成员变量，用于存储歌曲的当前播放状态，
+ *     并提供了构造函数来初始化该状态，同时提供了一个获取歌曲播放状态的方法。
+ *     此事件类可以用于通知用户界面更新播放状态的显示，
+ *     或者通知其他相关组件，如音频播放组件调整播放操作，
+ *     还可以用于记录播放状态日志等。
  * </pre>
  */
-
 public class SongStatusEvent {
+    // 存储歌曲的播放状态，不同的整数值可以表示不同的播放状态，
+    // 例如：0 表示停止，1 表示正在播放，2 表示暂停等，具体可根据应用需求定义
     private int songStatus;
 
+    // 构造函数，接收一个整数表示歌曲的播放状态，并将其存储在 songStatus 变量中
     public SongStatusEvent(int songStatus){
         this.songStatus = songStatus;
     }
 
+    // 获取歌曲播放状态的方法
     public int getSongStatus() {
         return songStatus;
     }

app/src/main/java/com/example/musicplayer/model/DataModel.java

@@ -25,92 +25,164 @@ import io.reactivex.Observable;
  *     author : 残渊
  *     time   : 2019/07/15
  *     desc   : 数据操作集合接口类
+ * 
+ *     该类实现了 NetworkHelper、DbHelper 和 PreferencesHelper 接口，
+ *     作为数据操作的集合接口类，将网络操作、数据库操作和偏好设置操作整合在一起。
+ *     它通过组合 NetworkHelperImpl、DbHelperImpl 和 PreferencesHelperImpl 类的实例，
+ *     实现了具体的数据操作功能，包括网络请求、数据库操作和播放模式的存储与获取。
  * </pre>
  */
-
+public class DataModel implements NetworkHelper, DbHelper, PreferencesHelper {
-public class DataModel implements NetworkHelper, DbHelper,PreferencesHelper {
+    // 声明一个 NetworkHelperImpl 类型的私有成员变量 mNetworkHelper，用于存储网络操作的实现类对象
     private NetworkHelperImpl mNetworkHelper;
+    // 声明一个 DbHelperImpl 类型的私有成员变量 mDbHelper，用于存储数据库操作的实现类对象
     private DbHelperImpl mDbHelper;
+    // 声明一个 PreferencesHelperImpl 类型的私有成员变量 mPreferencesHelper，用于存储偏好设置操作的实现类对象
     private PreferencesHelperImpl mPreferencesHelper;
 
-    public DataModel(NetworkHelperImpl networkHelper,DbHelperImpl dbHelper,PreferencesHelperImpl preferencesHelper){
+    // 构造函数，用于创建 DataModel 对象
+    // 参数 networkHelper：NetworkHelperImpl 类型的对象，提供网络操作的具体实现
+    // 参数 dbHelper：DbHelperImpl 类型的对象，提供数据库操作的具体实现
+    // 参数 preferencesHelper：PreferencesHelperImpl 类型的对象，提供偏好设置操作的具体实现
+    public DataModel(NetworkHelperImpl networkHelper, DbHelperImpl dbHelper, PreferencesHelperImpl preferencesHelper) {
+        // 将传入的网络操作实现类对象存储在 mNetworkHelper 成员变量中
         mNetworkHelper = networkHelper;
+        // 将传入的数据库操作实现类对象存储在 mDbHelper 成员变量中
         mDbHelper = dbHelper;
+        // 将传入的偏好设置操作实现类对象存储在 mPreferencesHelper 成员变量中
         mPreferencesHelper = preferencesHelper;
     }
 
+    // 实现 NetworkHelper 接口中的 getAlbumSong 方法，用于获取专辑歌曲信息
+    // 参数 id：专辑歌曲的唯一标识符，用于指定要获取的专辑歌曲
+    // 返回值：一个 Observable<AlbumSong> 对象，用于异步获取专辑歌曲信息
     @Override
     public Observable<AlbumSong> getAlbumSong(String id) {
+        // 调用 mNetworkHelper 的 getAlbumSong 方法来执行获取专辑歌曲的操作
         return mNetworkHelper.getAlbumSong(id);
     }
 
+    // 实现 NetworkHelper 接口中的 search 方法，用于搜索歌曲
+    // 参数 seek：搜索关键字，用于指定搜索的内容
+    // 参数 offset：搜索结果的偏移量，用于分页等操作
+    // 返回值：一个 Observable<SearchSong> 对象，用于异步获取搜索歌曲的结果
     @Override
     public Observable<SearchSong> search(String seek, int offset) {
+        // 调用 mNetworkHelper 的 search 方法来执行歌曲搜索操作
         return mNetworkHelper.search(seek, offset);
     }
 
+    // 实现 NetworkHelper 接口中的 searchAlbum 方法，用于搜索专辑
+    // 参数 seek：搜索关键字，用于指定搜索的内容
+    // 参数 offset：搜索结果的偏移量，用于分页等操作
+    // 返回值：一个 Observable<Album> 对象，用于异步获取搜索专辑的结果
     @Override
     public Observable<Album> searchAlbum(String seek, int offset) {
+        // 调用 mNetworkHelper 的 searchAlbum 方法来执行专辑搜索操作
         return mNetworkHelper.searchAlbum(seek, offset);
     }
 
+    // 实现 NetworkHelper 接口中的 getLrc 方法，用于获取歌词
+    // 参数 seek：搜索关键字，用于指定搜索的歌词内容
+    // 返回值：一个 Observable<SongLrc> 对象，用于异步获取歌词的结果
     @Override
     public Observable<SongLrc> getLrc(String seek) {
+        // 调用 mNetworkHelper 的 getLrc 方法来执行获取歌词的操作
         return mNetworkHelper.getLrc(seek);
     }
 
+    // 实现 NetworkHelper 接口中的 getOnlineSongLrc 方法，用于获取网络歌曲的歌词
+    // 参数 songId：歌曲的唯一标识符，用于指定要获取歌词的网络歌曲
+    // 返回值：一个 Observable<OnlineSongLrc> 对象，用于异步获取网络歌曲歌词的结果
     @Override
     public Observable<OnlineSongLrc> getOnlineSongLrc(String songId) {
+        // 调用 mNetworkHelper 的 getOnlineSongLrc 方法来执行获取网络歌曲歌词的操作
         return mNetworkHelper.getOnlineSongLrc(songId);
     }
 
+    // 实现 NetworkHelper 接口中的 getSingerImg 方法，用于获取歌手头像
+    // 参数 singer：歌手的名称，用于指定要获取头像的歌手
+    // 返回值：一个 Observable<SingerImg> 对象，用于异步获取歌手头像的结果
     @Override
     public Observable<SingerImg> getSingerImg(String singer) {
+        // 调用 mNetworkHelper 的 getSingerImg 方法来执行获取歌手头像的操作
         return mNetworkHelper.getSingerImg(singer);
     }
 
+    // 实现 NetworkHelper 接口中的 getSongUrl 方法，用于获取歌曲的播放地址
+    // 参数 data：与播放地址相关的数据，可能包含歌曲的相关信息
+    // 返回值：一个 Observable<SongUrl> 对象，用于异步获取歌曲播放地址的结果
     @Override
     public Observable<SongUrl> getSongUrl(String data) {
+        // 调用 mNetworkHelper 的 getSongUrl 方法来执行获取歌曲播放地址的操作
         return mNetworkHelper.getSongUrl(data);
     }
 
+    // 实现 DbHelper 接口中的 insertAllAlbumSong 方法，用于将专辑歌曲列表插入数据库
+    // 参数 songList：包含专辑歌曲信息的列表，其中元素类型为 AlbumSong.DataBean.ListBean
     @Override
     public void insertAllAlbumSong(List<AlbumSong.DataBean.ListBean> songList) {
-         mDbHelper.insertAllAlbumSong(songList);
+        // 调用 mDbHelper 的 insertAllAlbumSong 方法将专辑歌曲列表插入数据库
+        mDbHelper.insertAllAlbumSong(songList);
     }
 
+    // 实现 DbHelper 接口中的 getLocalMp3Info 方法，用于获取本地 MP3 信息
+    // 返回值：一个 List<LocalSong> 对象，存储本地歌曲信息
     @Override
     public List<LocalSong> getLocalMp3Info() {
+        // 调用 mDbHelper 的 getLocalMp3Info 方法来获取本地歌曲信息
         return mDbHelper.getLocalMp3Info();
     }
 
+    // 实现 DbHelper 接口中的 saveSong 方法，用于保存本地歌曲到数据库
+    // 参数 localSongs：要保存的本地歌曲列表，其中元素类型为 LocalSong
+    // 返回值：一个 boolean 值，表示保存操作是否成功
     @Override
     public boolean saveSong(List<LocalSong> localSongs) {
+        // 调用 mDbHelper 的 saveSong 方法来保存本地歌曲
         return mDbHelper.saveSong(localSongs);
     }
 
+    // 实现 DbHelper 接口中的 queryLove 方法，用于查询歌曲是否被收藏
+    // 参数 songId：歌曲的唯一标识符，用于指定要查询的歌曲
+    // 返回值：一个 boolean 值，表示歌曲是否被收藏
     @Override
     public boolean queryLove(String songId) {
+        // 调用 mDbHelper 的 queryLove 方法来查询歌曲是否被收藏
         return mDbHelper.queryLove(songId);
     }
 
+    // 实现 DbHelper 接口中的 saveToLove 方法，用于将歌曲收藏到数据库
+    // 参数 song：要收藏的歌曲对象，类型为 Song
+    // 返回值：一个 boolean 值，表示收藏操作是否成功
     @Override
     public boolean saveToLove(Song song) {
+        // 调用 mDbHelper 的 saveToLove 方法来执行收藏歌曲的操作
         return mDbHelper.saveToLove(song);
     }
 
+    // 实现 DbHelper 接口中的 deleteFromLove 方法，用于从收藏中删除歌曲
+    // 参数 songId：歌曲的唯一标识符，用于指定要删除收藏的歌曲
+    // 返回值：一个 boolean 值，表示删除操作是否成功
     @Override
     public boolean deleteFromLove(String songId) {
+        // 调用 mDbHelper 的 deleteFromLove 方法来执行从收藏中删除歌曲的操作
         return mDbHelper.deleteFromLove(songId);
     }
 
+    // 实现 PreferencesHelper 接口中的 setPlayMode 方法，用于设置播放模式
+    // 参数 mode：表示播放模式的整数，可用于设置不同的播放模式，如顺序播放、随机播放等
     @Override
     public void setPlayMode(int mode) {
+        // 调用 mPreferencesHelper 的 setPlayMode 方法来设置播放模式
         mPreferencesHelper.setPlayMode(mode);
     }
 
+    // 实现 PreferencesHelper 接口中的 getPlayMode 方法，用于获取播放模式
+    // 返回值：一个整数，表示当前的播放模式
     @Override
     public int getPlayMode() {
+        // 调用 mPreferencesHelper 的 getPlayMode 方法来获取播放模式
         return mPreferencesHelper.getPlayMode();
     }
 }

app/src/main/java/com/example/musicplayer/model/db/DbHelper.java

@@ -12,20 +12,72 @@ import java.util.List;
  *     author : 残渊
  *     time   : 2019/07/16
  *     desc   : 数据库操作接口
+ * 
+ *     该接口定义了一系列数据库操作的方法，是数据库操作的抽象层，
+ *     具体的数据库操作实现类需要实现该接口。
+ *     这些方法涵盖了不同的数据库操作，如插入、查询、更新和删除等，
+ *     主要用于音乐播放器应用中的歌曲和专辑信息的数据库操作。
  * </pre>
  */
-
 public interface DbHelper {
     /**
-     *  将所有搜索专辑列表中的歌曲都保存到网络歌曲数据库中
+     * 将所有搜索专辑列表中的歌曲都保存到网络歌曲数据库中
-     * @param songList 专辑列表
+     * 
+     * @param songList 专辑列表，包含要保存的歌曲信息，歌曲列表中的元素为 AlbumSong.DataBean.ListBean 类型
+     * 该方法用于将专辑中的歌曲存储到网络歌曲数据库中，可用于将用户搜索到的专辑歌曲保存到数据库中，
+     * 以便后续使用，例如在没有网络连接时也能播放这些歌曲，或者进行歌曲信息的持久化存储。
      */
     void insertAllAlbumSong(List<AlbumSong.DataBean.ListBean> songList);
-    List<LocalSong> getLocalMp3Info();  //得到本地列表
-    boolean saveSong(List<LocalSong> localSongs);//将本地音乐放到数据库中
 
-    boolean queryLove(String songId);//从数据库查找是否为收藏歌曲
+    /**
-    boolean saveToLove(Song song);//收藏歌曲
+     * 得到本地列表
-    boolean deleteFromLove(String songId);//取消收藏歌曲
+     * 该方法用于从数据库中获取本地歌曲的信息列表，返回的列表包含 LocalSong 类型的元素，
+     * 可以在需要显示本地歌曲列表或对本地歌曲进行操作时调用此方法，
+     * 如在用户打开本地音乐列表页面时，调用该方法获取本地歌曲列表信息。
+     * @return 存储本地歌曲信息的列表
+     */
+    List<LocalSong> getLocalMp3Info();
 
+    /**
+     * 将本地音乐放到数据库中
+     * 
+     * @param localSongs 要保存的本地歌曲列表，列表中的元素为 LocalSong 类型
+     * 该方法用于将本地歌曲存储到数据库中，可用于将用户添加的新的本地歌曲保存到数据库，
+     * 以便对本地歌曲进行管理，如更新本地歌曲信息、备份歌曲信息等。
+     * @return 操作是否成功的布尔值，如果存储成功返回 true，否则返回 false
+     */
+    boolean saveSong(List<LocalSong> localSongs);
+
+
+    /**
+     * 从数据库查找是否为收藏歌曲
+     * 
+     * @param songId 歌曲的唯一标识符，用于查找对应的歌曲
+     * 该方法用于根据歌曲的唯一标识符在数据库中查找该歌曲是否为收藏歌曲，
+     * 可在用户点击歌曲的收藏按钮时调用此方法，以判断该歌曲是否已经被收藏。
+     * @return 查找结果的布尔值，如果歌曲是收藏歌曲返回 true，否则返回 false
+     */
+    boolean queryLove(String songId);
+
+
+    /**
+     * 收藏歌曲
+     * 
+     * @param song 要收藏的歌曲对象，为 Song 类型
+     * 该方法用于将指定的歌曲收藏到数据库中，可在用户点击收藏按钮且歌曲尚未被收藏时调用，
+     * 例如用户决定收藏一首正在播放的歌曲，可调用该方法将其收藏。
+     * @return 操作是否成功的布尔值，如果收藏成功返回 true，否则返回 false
+     */
+    boolean saveToLove(Song song);
+
+
+    /**
+     * 取消收藏歌曲
+     * 
+     * @param songId 要取消收藏的歌曲的唯一标识符
+     * 该方法用于根据歌曲的唯一标识符将歌曲从收藏列表中移除，
+     * 可在用户取消收藏歌曲时调用，以更新数据库中的收藏状态。
+     * @return 操作是否成功的布尔值，如果取消收藏成功返回 true，否则返回 false
+     */
+    boolean deleteFromLove(String songId);
 }

app/src/main/java/com/example/musicplayer/model/db/DbHelperImpl.java

@@ -22,136 +22,205 @@ import java.util.List;
  *     author : 残渊
  *     time   : 2019/07/16
  *     desc   : 数据库操作类
+ * 
+ *     该类实现了 DbHelper 接口，提供了具体的数据库操作实现。
+ *     它使用 LitePal 作为数据库操作框架，处理各种音乐相关信息的存储、查询、更新和删除操作，
+ *     包括网络歌曲、本地歌曲以及收藏歌曲的操作。
  * </pre>
  */
-
 public class DbHelperImpl implements DbHelper {
 
     @Override
     public void insertAllAlbumSong(List<AlbumSong.DataBean.ListBean> songList) {
+        // 先删除 OnlineSong 表中的所有数据
         LitePal.deleteAll(OnlineSong.class);
+        // 遍历歌曲列表，将每首歌曲的信息存储到 OnlineSong 表中
         for (int i = 0; i < songList.size(); i++) {
             AlbumSong.DataBean.ListBean song = songList.get(i);
             OnlineSong onlineSong = new OnlineSong();
+            // 设置歌曲的 ID，从 1 开始递增
             onlineSong.setId(i + 1);
+            // 设置歌曲名称
             onlineSong.setName(song.getSongname());
+            // 设置歌手，取第一个歌手的名字
             onlineSong.setSinger(song.getSinger().get(0).getName());
+            // 设置歌曲的唯一标识符
             onlineSong.setSongId(song.getSongmid());
+            // 设置歌曲时长
             onlineSong.setDuration(song.getInterval());
-            onlineSong.setPic(Api.ALBUM_PIC + song.getAlbummid()+Api.JPG);
+            // 设置歌曲封面图片的 URL
+            onlineSong.setPic(Api.ALBUM_PIC + song.getAlbummid() + Api.JPG);
+            // 暂时设置歌曲的 URL 和歌词为 null
             onlineSong.setUrl(null);
             onlineSong.setLrc(null);
+            // 保存歌曲信息到数据库
             onlineSong.save();
         }
     }
 
     @Override
     public List<LocalSong> getLocalMp3Info() {
+        // 创建一个用于存储本地歌曲信息的列表
         List<LocalSong> mp3InfoList = new ArrayList<>();
-        getFromDownloadFile(mp3InfoList); //从下载列表中读取歌曲文件
+        // 从下载列表中读取歌曲文件
+        getFromDownloadFile(mp3InfoList);
+        // 查询系统媒体库中的音频文件
         Cursor cursor = App.getContext().getContentResolver().query(
                 MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, null, null, null,
                 MediaStore.Audio.Media.DEFAULT_SORT_ORDER);
+        // 遍历查询结果
         for (int i = 0; i < cursor.getCount(); i++) {
             cursor.moveToNext();
             LocalSong mp3Info = new LocalSong();
+            // 获取音乐标题
             String title = cursor.getString((cursor
-                    .getColumnIndex(MediaStore.Audio.Media.TITLE)));//音乐标题
+                   .getColumnIndex(MediaStore.Audio.Media.TITLE)));
+            // 获取艺术家
             String artist = cursor.getString(cursor
-                    .getColumnIndex(MediaStore.Audio.Media.ARTIST));//艺术家
+                   .getColumnIndex(MediaStore.Audio.Media.ARTIST));
+            // 获取时长
             long duration = cursor.getLong(cursor
-                    .getColumnIndex(MediaStore.Audio.Media.DURATION));//时长
+                   .getColumnIndex(MediaStore.Audio.Media.DURATION));
+            // 获取文件大小
             long size = cursor.getLong(cursor
-                    .getColumnIndex(MediaStore.Audio.Media.SIZE));    //文件大小
+                   .getColumnIndex(MediaStore.Audio.Media.SIZE));
+            // 获取文件路径
             String url = cursor.getString(cursor
-                    .getColumnIndex(MediaStore.Audio.Media.DATA));     //文件路径
+                   .getColumnIndex(MediaStore.Audio.Media.DATA));
+            // 获取是否为音乐的标记
             int isMusic = cursor.getInt(cursor
-                    .getColumnIndex(MediaStore.Audio.Media.IS_MUSIC));//是否为音乐
+                   .getColumnIndex(MediaStore.Audio.Media.IS_MUSIC));
-            if (isMusic != 0) {//只把音乐添加到集合当中
+            // 只添加音乐文件到集合中
+            if (isMusic!= 0) {
+                // 对于文件大小大于 800KB 的文件进行处理
                 if (size > 1000 * 800) {
-                    // 注释部分是切割标题，分离出歌曲名和歌手 （本地媒体库读取的歌曲信息不规范）
+                    // 对于本地媒体库读取的歌曲信息进行规范处理，分离歌曲名和歌手
                     if (title.contains("-")) {
                         String[] str = title.split("-");
                         artist = str[0];
                         title = str[1];
                     }
+                    // 设置歌曲名称
                     mp3Info.setName(title.trim());
+                    // 设置歌手
                     mp3Info.setSinger(artist);
+                    // 设置时长（单位为秒）
                     mp3Info.setDuration(duration / 1000);
+                    // 设置文件路径
                     mp3Info.setUrl(url);
-                    mp3Info.setSongId(i+"");
+                    // 设置歌曲的唯一标识符
+                    mp3Info.setSongId(i + "");
+                    // 将歌曲信息添加到列表中
                     mp3InfoList.add(mp3Info);
                 }
             }
         }
+        // 关闭游标
         cursor.close();
+        // 返回存储本地歌曲信息的列表
         return mp3InfoList;
     }
 
     @Override
     public boolean saveSong(List<LocalSong> localSongs) {
+        // 先删除 LocalSong 表中的所有数据
         LitePal.deleteAll(LocalSong.class);
+        // 遍历要保存的本地歌曲列表，将歌曲信息存储到数据库中
         for (LocalSong localSong : localSongs) {
             LocalSong song = new LocalSong();
+            // 设置歌曲名称
             song.setName(localSong.getName());
+            // 设置歌手
             song.setSinger(localSong.getSinger());
+            // 设置文件路径
             song.setUrl(localSong.getUrl());
+            // 设置歌曲的唯一标识符
             song.setSongId(localSong.getSongId());
+            // 设置时长
             song.setDuration(localSong.getDuration());
-            if(!song.save()) return false;
+            // 保存歌曲信息，如果保存失败返回 false
+            if (!song.save()) return false;
         }
+        // 保存成功返回 true
         return true;
     }
 
     @Override
     public boolean queryLove(String songId) {
-         List<Love> love=LitePal.where("songId=?",songId).find(Love.class);
+        // 根据歌曲的唯一标识符查询收藏歌曲列表
-        return love.size() != 0;
+        List<Love> love = LitePal.where("songId=?", songId).find(Love.class);
+        // 如果查询结果不为空，表示歌曲已被收藏，返回 true，否则返回 false
+        return love.size()!= 0;
     }
 
     @Override
     public boolean saveToLove(Song song) {
-        Love love =new Love();
+        // 创建一个新的收藏歌曲对象
+        Love love = new Love();
+        // 设置歌曲名称
         love.setName(song.getSongName());
+        // 设置歌手
         love.setSinger(song.getSinger());
+        // 设置文件路径
         love.setUrl(song.getUrl());
+        // 设置歌曲封面图片的 URL
         love.setPic(song.getImgUrl());
+        // 设置时长
         love.setDuration(song.getDuration());
+        // 设置歌曲的唯一标识符
         love.setSongId(song.getSongId());
+        // 设置是否为在线歌曲
         love.setOnline(song.isOnline());
+        // 设置歌曲的 QQ 标识符
         love.setQqId(song.getQqId());
+        // 设置歌曲的媒体标识符
         love.setMediaId(song.getMediaId());
+        // 设置是否已下载
         love.setDownload(song.isDownload());
+        // 保存收藏歌曲信息，保存成功返回 true，否则返回 false
         return love.save();
     }
 
     @Override
     public boolean deleteFromLove(String songId) {
-        return LitePal.deleteAll(Love.class,"songId=?",songId) !=0;
+        // 根据歌曲的唯一标识符删除收藏歌曲，删除成功返回 true，否则返回 false
+        return LitePal.deleteAll(Love.class, "songId=?", songId)!= 0;
     }
 
-    //从下载列表中读取文件
+    // 从下载列表中读取文件的方法
-    private void getFromDownloadFile(List<LocalSong> songList){
+    private void getFromDownloadFile(List<LocalSong> songList) {
+        // 获取存储歌曲的目录
         File file = new File(Api.STORAGE_SONG_FILE);
-        if(!file.exists()) {
+        // 如果目录不存在，则创建目录
+        if (!file.exists()) {
             file.mkdirs();
             return;
         }
-
+        // 获取目录下的所有文件
         File[] subFile = file.listFiles();
+        // 遍历文件列表
         for (File value : subFile) {
             String songFileName = value.getName();
+            // 提取歌曲文件名（不包含后缀）
             String songFile = songFileName.substring(0, songFileName.lastIndexOf("."));
+            // 分割文件名，包含歌手、歌曲名、时长、歌曲唯一标识符和文件大小
             String[] songValue = songFile.split("-");
+            // 获取文件大小
             long size = Long.valueOf(songValue[4]);
-            //如果文件的大小不等于实际大小，则表示该歌曲还未下载完成，被人为暂停，故跳过该歌曲，不加入到已下载集合
+            // 如果文件大小不等于实际大小，说明歌曲未下载完成，跳过该歌曲
-            if(size != value.length()) continue;
+            if (size!= value.length()) continue;
-            LocalSong song =new LocalSong();
+            LocalSong song = new LocalSong();
+            // 设置歌手
             song.setSinger(songValue[0]);
+            // 设置歌曲名称
             song.setName(songValue[1]);
+            // 设置时长
             song.setDuration(Long.valueOf(songValue[2]));
+            // 设置歌曲的唯一标识符
             song.setSongId(songValue[3]);
+            // 设置文件路径
             song.setUrl(Api.STORAGE_SONG_FILE + songFileName);
+            // 将歌曲信息添加到歌曲列表中
             songList.add(song);
         }
     }

app/src/main/java/com/example/musicplayer/model/https/NetworkHelper.java

@@ -16,16 +16,90 @@ import io.reactivex.Observable;
  *     author : 残渊
  *     time   : 2019/07/15
  *     desc   : 网络操作接口集合
+ * 
+ *     该接口定义了音乐播放器应用中所需的各种网络操作接口，
+ *     利用 RxJava 的 Observable 作为返回类型，实现异步的网络请求和响应处理。
+ *     包括搜索歌曲、搜索专辑、获取专辑歌曲、获取歌词、获取歌手头像以及获取歌曲播放地址等操作。
+ *     这些接口为上层业务逻辑提供了与网络服务交互的抽象，具体的网络请求实现需要在实现类中完成。
  * </pre>
  */
-
 public interface NetworkHelper {
-    Observable<AlbumSong> getAlbumSong(String id); //得到专辑
+    /**
-    Observable<SearchSong> search(String seek, int offset); //搜索歌曲
+     * 得到专辑
-    Observable<Album> searchAlbum(String seek,int offset);//搜索照片
+     * 
-    Observable<SongLrc> getLrc(String seek);//获取歌词
+     * @param id 专辑的唯一标识符
-    Observable<OnlineSongLrc> getOnlineSongLrc(String songId);//获取网络歌曲的歌词
+     * 
-    Observable<SingerImg> getSingerImg(String singer);//获取歌手头像
+     * 该方法返回一个 Observable<AlbumSong>，用于异步获取专辑歌曲信息，
-    Observable<SongUrl> getSongUrl(String data);//获取播放地址
+     * 可以根据提供的专辑唯一标识符向服务器请求专辑的详细信息，
-}
+     * 例如歌曲列表、专辑封面等信息。
+     */
+    Observable<AlbumSong> getAlbumSong(String id); 
+
+    /**
+     * 搜索歌曲
+     * 
+     * @param seek 搜索关键字
+     * @param offset 搜索结果的偏移量，用于分页
+     * 
+     * 该方法返回一个 Observable<SearchSong>，用于异步搜索歌曲，
+     * 根据搜索关键字和偏移量向服务器请求歌曲信息，
+     * 可用于搜索不同歌曲，并根据偏移量获取不同页的搜索结果。
+     */
+    Observable<SearchSong> search(String seek, int offset); 
+
+    /**
+     * 搜索照片（此处可能是文档注释错误，推测应该是搜索专辑）
+     * 
+     * @param seek 搜索关键字
+     * @param offset 搜索结果的偏移量，用于分页
+     * 
+     * 该方法返回一个 Observable<Album>，用于异步搜索专辑，
+     * 根据搜索关键字和偏移量向服务器请求专辑信息，
+     * 可用于搜索不同的专辑，并根据偏移量获取不同页的搜索结果。
+     */
+    Observable<Album> searchAlbum(String seek,int offset);
 
+    /**
+     * 获取歌词
+     * 
+     * @param seek 搜索关键字
+     * 
+     * 该方法返回一个 Observable<SongLrc>，用于异步搜索歌词，
+     * 根据搜索关键字向服务器请求歌词信息，
+     * 可用于查找歌曲的歌词。
+     */
+    Observable<SongLrc> getLrc(String seek);
+
+    /**
+     * 获取网络歌曲的歌词
+     * 
+     * @param songId 歌曲的唯一标识符
+     * 
+     * 该方法返回一个 Observable<OnlineSongLrc>，用于异步获取网络歌曲的歌词，
+     * 根据歌曲的唯一标识符向服务器请求歌词，
+     * 可用于在播放网络歌曲时获取其对应的歌词。
+     */
+    Observable<OnlineSongLrc> getOnlineSongLrc(String songId);
+
+    /**
+     * 获取歌手头像
+     * 
+     * @param singer 歌手名称
+     * 
+     * 该方法返回一个 Observable<SingerImg>，用于异步获取歌手头像，
+     * 根据歌手名称向服务器请求头像信息，
+     * 可用于显示歌手的头像。
+     */
+    Observable<SingerImg> getSingerImg(String singer);
+
+    /**
+     * 获取播放地址
+     * 
+     * @param data 与播放地址相关的数据，可能包含歌曲的相关信息
+     * 
+     * 该方法返回一个 Observable<SongUrl>，用于异步获取歌曲的播放地址，
+     * 根据传入的数据向服务器请求播放地址，
+     * 可用于获取歌曲的播放链接，以便进行播放操作。
+     */
+    Observable<SongUrl> getSongUrl(String data);
+}

app/src/main/java/com/example/musicplayer/model/https/NetworkHelperImpl.java

@@ -17,46 +17,60 @@ import io.reactivex.Observable;
  *     author : 残渊
  *     time   : 2019/07/15
  *     desc   : 网络操作实现类
+ * 
+ *     该类实现了 NetworkHelper 接口，作为网络操作的具体实现类。
+ *     它依赖于 RetrofitService 来执行实际的网络请求操作，
+ *     通过调用 RetrofitService 中的方法来完成各种网络操作，
+ *     如搜索歌曲、搜索专辑、获取歌词、获取歌手头像、获取歌曲播放地址等。
+ *     利用 RxJava 的 Observable 来处理异步网络请求的结果。
  * </pre>
  */
-
 public class NetworkHelperImpl implements NetworkHelper {
+    // 存储 RetrofitService 实例，用于执行网络请求
     private RetrofitService mRetrofitService;
 
+    // 构造函数，接收 RetrofitService 实例并存储
     public NetworkHelperImpl(RetrofitService retrofitService){
         mRetrofitService = retrofitService;
     }
 
+    // 获取专辑歌曲的方法，调用 RetrofitService 的 getAlbumSong 方法
     @Override
     public Observable<AlbumSong> getAlbumSong(String id) {
         return mRetrofitService.getAlbumSong(id);
     }
 
+    // 搜索歌曲的方法，调用 RetrofitService 的 search 方法
     @Override
     public Observable<SearchSong> search(String seek, int offset) {
         return mRetrofitService.search(seek, offset);
     }
 
+    // 搜索专辑的方法，调用 RetrofitService 的 searchAlbum 方法
     @Override
     public Observable<Album> searchAlbum(String seek, int offset) {
         return mRetrofitService.searchAlbum(seek, offset);
     }
 
+    // 获取歌词的方法，调用 RetrofitService 的 getLrc 方法
     @Override
     public Observable<SongLrc> getLrc(String seek) {
         return mRetrofitService.getLrc(seek);
     }
 
+    // 获取网络歌曲歌词的方法，调用 RetrofitService 的 getOnlineSongLrc 方法
     @Override
     public Observable<OnlineSongLrc> getOnlineSongLrc(String songId) {
         return mRetrofitService.getOnlineSongLrc(songId);
     }
 
+    // 获取歌手头像的方法，调用 RetrofitService 的 getSingerImg 方法
     @Override
     public Observable<SingerImg> getSingerImg(String singer) {
         return mRetrofitService.getSingerImg(singer);
     }
 
+    // 获取歌曲播放地址的方法，调用 RetrofitService 的 getSongUrl 方法
     @Override
     public Observable<SongUrl> getSongUrl(String data) {
         return mRetrofitService.getSongUrl(data);

app/src/main/java/com/example/musicplayer/model/https/RetrofitFactory.java

@@ -18,82 +18,113 @@ import retrofit2.converter.gson.GsonConverterFactory;
  * <pre>
  *     author : 残渊
  *     time   : 2019/07/15
- *     desc   : 封装Retrofit，方便外部调用
+ *     desc   : 封装 Retrofit，方便外部调用
+ * 
+ *     该类是一个 Retrofit 的工厂类，用于创建和配置 Retrofit 实例，
+ *     并提供了不同类型的 Retrofit 实例以满足不同的网络请求需求，
+ *     如通用请求、歌手照片请求和歌曲播放地址请求等。
+ *     它使用 OkHttpClient 进行网络请求的底层配置，
+ *     并使用 Gson 进行 JSON 数据的解析和转换，
+ *     同时结合 RxJava2 来处理异步请求结果。
  * </pre>
  */
-
 public class RetrofitFactory {
+    // 存储 OkHttpClient 实例，用于网络请求
     private static OkHttpClient sOkHttpClient;
+    // 存储通用的 Retrofit 实例
     private static Retrofit sRetrofit;
+    // 存储用于歌曲播放地址请求的 Retrofit 实例
     private static Retrofit songUrlRetrofit;
+    // 存储用于歌手照片请求的 Retrofit 实例
     private static Retrofit sSingerPicRetrofit;
 
 
-    // 创建网络请求Observable
+    // 创建网络请求 Observable 的方法，使用通用的 Retrofit 实例
     public static RetrofitService createRequest() {
         return getRetrofit().create(RetrofitService.class);
     }
 
+    // 创建用于歌手相关请求的网络请求 Observable 的方法，使用歌手照片的 Retrofit 实例
     public static RetrofitService createRequestOfSinger() {
         return getRetrofitOfSinger().create(RetrofitService.class);
     }
 
-    public static RetrofitService createRequestOfSongUrl(){
+    // 创建用于歌曲播放地址请求的网络请求 Observable 的方法，使用歌曲播放地址的 Retrofit 实例
+    public static RetrofitService createRequestOfSongUrl() {
         return getRetrofitOfSongUrl().create(RetrofitService.class);
     }
-    // 配置Retrofit
+
+    // 配置通用的 Retrofit 实例
     private synchronized static Retrofit getRetrofit() {
         if (sRetrofit == null) {
             sRetrofit = new Retrofit.Builder()
-                    .baseUrl(Api.FIDDLER_BASE_QQ_URL) // 对应服务端的host
+                    // 设置基础 URL，对应服务端的 host
-                    .client(getOkHttpClient())
+                  .baseUrl(Api.FIDDLER_BASE_QQ_URL) 
-                    .addConverterFactory(GsonConverterFactory.create(new GsonBuilder().setLenient().create())) // 这里还结合了Gson
+                    // 使用 OkHttpClient 进行网络请求
-                    .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 把Retrofit请求转化成RxJava的Observable
+                  .client(getOkHttpClient()) 
-                    .build();
+                    // 使用 Gson 进行 JSON 数据的解析和转换，使用了宽松模式
+                  .addConverterFactory(GsonConverterFactory.create(new GsonBuilder().setLenient().create())) 
+                    // 将 Retrofit 请求转化成 RxJava 的 Observable，以便使用 RxJava 处理异步请求结果
+                  .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) 
+                   .build();
         }
         return sRetrofit;
     }
 
-    // 获取歌手照片
+    // 配置用于歌手照片请求的 Retrofit 实例
     private synchronized static Retrofit getRetrofitOfSinger() {
         if (sSingerPicRetrofit == null) {
             sSingerPicRetrofit = new Retrofit.Builder()
-                    .baseUrl(Api.SINGER_PIC_BASE_URL) // 对应服务端的host
+                    // 设置基础 URL，对应服务端的 host
-                    .client(getOkHttpClient())
+                  .baseUrl(Api.SINGER_PIC_BASE_URL) 
-                    .addConverterFactory(GsonConverterFactory.create()) // 这里还结合了Gson
+                    // 使用 OkHttpClient 进行网络请求
-                    .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 把Retrofit请求转化成RxJava的Observable
+                  .client(getOkHttpClient()) 
-                    .build();
+                    // 使用 Gson 进行 JSON 数据的解析和转换
+                  .addConverterFactory(GsonConverterFactory.create()) 
+                    // 将 Retrofit 请求转化成 RxJava 的 Observable
+                  .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) 
+                   .build();
         }
         return sSingerPicRetrofit;
     }
 
-    //得到播放地址
+    // 配置用于歌曲播放地址请求的 Retrofit 实例
     private synchronized static Retrofit getRetrofitOfSongUrl() {
         if (songUrlRetrofit == null) {
             songUrlRetrofit = new Retrofit.Builder()
-                    .baseUrl(Api.FIDDLER_BASE_SONG_URL) // 对应服务端的host
+                    // 设置基础 URL，对应服务端的 host
-                    .client(getOkHttpClient())
+                  .baseUrl(Api.FIDDLER_BASE_SONG_URL) 
-                    .addConverterFactory(GsonConverterFactory.create()) // 这里还结合了Gson
+                    // 使用 OkHttpClient 进行网络请求
-                    .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 把Retrofit请求转化成RxJava的Observable
+                  .client(getOkHttpClient()) 
-                    .build();
+                    // 使用 Gson 进行 JSON 数据的解析和转换
+                  .addConverterFactory(GsonConverterFactory.create()) 
+                    // 将 Retrofit 请求转化成 RxJava 的 Observable
+                  .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) 
+                   .build();
         }
         return songUrlRetrofit;
     }
 
-    //配置OkHttp
+    // 配置 OkHttpClient 实例
     private synchronized static OkHttpClient getOkHttpClient() {
         if (sOkHttpClient == null) {
+            // 创建一个 HttpLoggingInterceptor 用于打印网络请求日志
             HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor(message -> {
-                //打印retrofit日志
+                // 打印 retrofit 日志
                 Log.i("RetrofitLog","retrofitBack = "+message);
             });
+            // 设置日志级别为 BODY，会打印请求和响应的详细信息
             loggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
             sOkHttpClient = new OkHttpClient.Builder()
-                    .connectTimeout(100, TimeUnit.SECONDS)
+                    // 设置连接超时时间
-                    .readTimeout(100,TimeUnit.SECONDS)
+                  .connectTimeout(100, TimeUnit.SECONDS) 
-                    .writeTimeout(100,TimeUnit.SECONDS)
+                    // 设置读取超时时间
-                    //.addInterceptor(loggingInterceptor)  日志
+                  .readTimeout(100,TimeUnit.SECONDS) 
-                    .build();
+                    // 设置写入超时时间
+                  .writeTimeout(100,TimeUnit.SECONDS) 
+                    // 可以添加日志拦截器，这里被注释掉了
+                    //.addInterceptor(loggingInterceptor) 
+                   .build();
         }
         return sOkHttpClient;
     }

app/src/main/java/com/example/musicplayer/model/https/api/RetrofitService.java

@@ -22,43 +22,73 @@ import retrofit2.http.Query;
  *     author : 残渊
  *     time   : 2019/07/15
  *     desc   :
+ * 
+ *     该接口定义了使用 Retrofit 进行网络请求的服务方法，
+ *     主要用于音乐播放器应用中与服务器的各种交互操作，
+ *     包括搜索歌曲、搜索专辑、获取专辑歌曲、获取歌曲播放地址、获取歌词和获取歌手照片等操作。
+ *     每个方法对应一个特定的网络 API 端点，并使用 RxJava 的 Observable 来处理异步网络请求的结果。
  * </pre>
  */
-
 public interface RetrofitService {
     /**
-     *  搜索歌曲：https://c.y.qq.com/soso/fcgi-bin/client_search_cp?p=2&n=2&w=周杰伦&format=json
+     * 搜索歌曲：https://c.y.qq.com/soso/fcgi-bin/client_search_cp?p=2&n=2&w=周杰伦&format=json
+     * 
+     * @param seek 搜索关键词
+     * @param offset 搜索结果的偏移量（页数）
+     * 
+     * 该方法使用 @GET 注解和 Api.SEARCH_SONG 作为请求的 URL，
+     * 通过 @Query 注解添加查询参数 "w"（搜索关键词）和 "p"（偏移量），
+     * 返回一个 Observable<SearchSong>，用于接收搜索歌曲的结果。
      */
     @GET(Api.SEARCH_SONG)
     Observable<SearchSong> search(@Query("w") String seek, @Query("p")int offset);
 
     /**
      * 搜索专辑：https://c.y.qq.com/soso/fcgi-bin/client_search_cp?p=1&n=2&w=林宥嘉&format=json&t=8
+     * 
      * @param seek 搜索关键字
      * @param offset 页数
+     * 
+     * 该方法使用 @GET 注解和 Api.SEARCH_ALBUM 作为请求的 URL，
+     * 通过 @Query 注解添加查询参数 "w"（搜索关键词）和 "p"（偏移量），
+     * 返回一个 Observable<Album>，用于接收搜索专辑的结果。
      */
     @GET(Api.SEARCH_ALBUM)
     Observable<Album> searchAlbum(@Query("w") String seek, @Query("p")int offset);
 
     /**
      * 专辑详细：https://c.y.qq.com/v8/fcg-bin/fcg_v8_album_info_cp.fcg?albummid=004YodY33zsWTT&format=json
-     * @param id 专辑mid
+     * 
+     * @param id 专辑的 mid 标识符
+     * 
+     * 该方法使用 @GET 注解和 Api.ALBUM_DETAIL 作为请求的 URL，
+     * 通过 @Query 注解添加查询参数 "albummid"（专辑的 mid），
+     * 返回一个 Observable<AlbumSong>，用于接收专辑歌曲的结果。
      */
     @GET(Api.ALBUM_DETAIL)
     Observable<AlbumSong> getAlbumSong(@Query("albummid")String id);
 
     /**
-     * 得到歌曲的播放地址，变化的只有songmid，即{}所示
+     * 得到歌曲的播放地址，变化的只有 songmid，即{}所示
      * https://u.y.qq.com/cgi-bin/musicu.fcg?format=json&data=%7B%22req_0%22%3A%7B%22module%22%3A%22vkey.GetVkeyServer%22%2C%22method%22%3A%22CgiGetVkey%22%2C%22param%22%3A%7B%22guid%22%3A%22358840384%22%2C%22       +
      * songmid%22%3A%5B%22{003wFozn3V3Ra0} +
      * %22%5D%2C%22songtype%22%3A%5B0%5D%2C%22uin%22%3A%221443481947%22%2C%22loginflag%22%3A1%2C%22platform%22%3A%2220%22%7D%7D%2C%22comm%22%3A%7B%22uin%22%3A%221443481947%22%2C%22format%22%3A%22json%22%2C%22ct%22%3A24%2C%22cv%22%3A0%7D%7D
+     * 
+     * 该方法使用 @GET 注解和 Api.SONG_URL 作为请求的 URL，
+     * 通过 @Query 注解添加查询参数 "data"（编码为 true），
+     * 返回一个 Observable<SongUrl>，用于接收歌曲播放地址的结果。
      */
     @GET(Api.SONG_URL)
     Observable<SongUrl> getSongUrl(@Query(value = "data",encoded = true) String data);
 
     /**
-     * 根据songmid获取歌词：https://c.y.qq.com/lyric/fcgi-bin/fcg_query_lyric_new.fcg?songmid=000wocYU11tSzS&format=json&nobase64=1
+     * 根据 songmid 获取歌词：https://c.y.qq.com/lyric/fcgi-bin/fcg_query_lyric_new.fcg?songmid=000wocYU11tSzS&format=json&nobase64=1
-     * headers中的Referer是qq用来防盗链的
+     * headers 中的 Referer 是 qq 用来防盗链的
+     * 
+     * 该方法使用 @GET 注解和 Api.ONLINE_SONG_LRC 作为请求的 URL，
+     * 通过 @Headers 注解添加请求头 Api.HEADER_REFERER 用于防盗链，
+     * 通过 @Query 注解添加查询参数 "songmid"（歌曲的 mid），
+     * 返回一个 Observable<OnlineSongLrc>，用于接收在线歌曲歌词的结果。
      */
     @Headers(Api.HEADER_REFERER)
     @GET(Api.ONLINE_SONG_LRC)
@@ -66,18 +96,29 @@ public interface RetrofitService {
 
     /**
      * 搜索歌词：https://c.y.qq.com/soso/fcgi-bin/client_search_cp?p=1&n=1&w=说谎&format=json&t=7
+     * 
      * @param seek 关键词
+     * 
+     * 该方法使用 @GET 注解和 Api.SONG_LRC 作为请求的 URL，
+     * 通过 @Query 注解添加查询参数 "w"（搜索关键词），
+     * 返回一个 Observable<SongLrc>，用于接收搜索歌词的结果。
      */
     @GET(Api.SONG_LRC)
     Observable<SongLrc> getLrc(@Query("w") String seek);
 
     /**
      * 得到歌手照片，主要用于本地音乐：http://music.163.com/api/search/get/web?s=刘瑞琦&type=100
+     * 
      * @param singer 歌手名字
+     * 
+     * 该方法使用 @POST 注解和 Api.SINGER_PIC 作为请求的 URL，
+     * 通过 @Headers 注解添加请求头 Api.HEADER_USER_AGENT，
+     * 通过 @FormUrlEncoded 注解表示使用表单编码，
+     * 通过 @Field 注解添加表单字段 "s"（歌手名字），
+     * 返回一个 Observable<SingerImg>，用于接收歌手照片的结果。
      */
     @Headers(Api.HEADER_USER_AGENT)
     @POST(Api.SINGER_PIC)
     @FormUrlEncoded
     Observable<SingerImg> getSingerImg(@Field("s")String singer);
-
 }

app/src/main/java/com/example/musicplayer/model/prefs/PreferencesHelper.java

@@ -5,10 +5,18 @@ package com.example.musicplayer.model.prefs;
  *     author : 残渊
  *     time   : 2019/09/09
  *     desc   : 存储状态抽象类
+ * 
+ *     该接口定义了存储播放状态的抽象方法，
+ *     作为存储状态的抽象层，具体的存储实现类需要实现该接口。
+ *     包含设置播放状态和获取播放状态的方法，
+ *     可用于保存和读取音乐播放器的播放模式信息，
+ *     例如顺序播放、随机播放、单曲循环等模式。
  * </pre>
  */
-
 public interface PreferencesHelper {
-    void setPlayMode(int mode);  //保存播放状态
+    // 保存播放状态的方法，接收一个整数表示播放模式
-    int getPlayMode();//得到播放状态
+    void setPlayMode(int mode);  
+
+    // 获取播放状态的方法，返回一个整数表示播放模式
+    int getPlayMode(); 
 }

app/src/main/java/com/example/musicplayer/model/prefs/PreferencesHelperImpl.java

@@ -11,23 +11,33 @@ import com.example.musicplayer.app.Constant;
  *     author : 残渊
  *     time   : 2019/09/09
  *     desc   : 保存状态的实现类
+ * 
+ *     该类实现了 PreferencesHelper 接口，使用 SharedPreferences 来存储和获取播放模式信息。
+ *     它通过 App.getContext() 获取应用上下文，并使用 Constant.SHARED_PREFERENCES_NAME 作为 SharedPreferences 的名称，
+ *     实现了保存播放模式和获取播放模式的具体逻辑。
  * </pre>
  */
-
 public class PreferencesHelperImpl implements PreferencesHelper{
+    // 存储 SharedPreferences 实例，用于存储播放模式等信息
     private SharedPreferences mPreferences;
 
+    // 构造函数，获取 SharedPreferences 实例
     public PreferencesHelperImpl(){
+        // 获取 SharedPreferences 实例，使用应用上下文和预定义的名称，且为私有模式
         mPreferences = App.getContext().getSharedPreferences(Constant.SHARED_PREFERENCES_NAME, Context.MODE_PRIVATE);
     }
 
+    // 实现接口中的设置播放模式方法，将播放模式存储到 SharedPreferences 中
     @Override
     public void setPlayMode(int mode) {
+        // 编辑 SharedPreferences 并存储播放模式，使用 Constant.PREFS_PLAY_MODE 作为键，mode 作为值，并使用 apply 方法异步保存
         mPreferences.edit().putInt(Constant.PREFS_PLAY_MODE,mode).apply();
     }
 
+    // 实现接口中的获取播放模式方法，从 SharedPreferences 中获取播放模式
     @Override
     public int getPlayMode() {
+        // 从 SharedPreferences 中获取播放模式，使用 Constant.PREFS_PLAY_MODE 作为键，若不存在则默认返回 0
         return mPreferences.getInt(Constant.PREFS_PLAY_MODE,0);
     }
 }

app/src/main/java/com/example/musicplayer/presenter/AlbumSongPresenter.java

@@ -19,32 +19,53 @@ import static com.example.musicplayer.view.search.AlbumSongFragment.ALBUM_SONG;
 
 /**
  * Created by 残渊 on 2018/11/27.
+ *
+ * <pre>
+ * 该类是一个专辑歌曲的 Presenter 类，它继承自 BasePresenter 并实现了 IAlbumSongContract.Presenter 接口。
+ * 主要负责处理与专辑歌曲相关的业务逻辑，如获取专辑详情和插入所有专辑歌曲。
+ * 它使用 RxJava 进行异步操作，将网络请求调度到 IO 线程，将结果处理调度到主线程。
+ * 并通过 BaseObserver 对网络请求结果进行观察和处理，根据不同情况更新视图状态。
+ * </pre>
  */
-
 public class AlbumSongPresenter extends BasePresenter<IAlbumSongContract.View> implements IAlbumSongContract.Presenter {
 
+    // 用于日志输出的 TAG 常量，方便在日志中识别该类
     private final static String TAG = "AlbumSongPresenter";
 
 
+    // 实现 IAlbumSongContract.Presenter 接口中的 getAlbumDetail 方法，用于获取专辑的详细信息
     @Override
     public void getAlbumDetail(String id, int type) {
+        // 使用 addRxSubscribe 方法添加 RxJava 的订阅操作
         addRxSubscribe(
+                // 调用 mModel 的 getAlbumSong 方法获取专辑歌曲信息，mModel 可能是在 BasePresenter 中声明的对象
                 mModel.getAlbumSong(id)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程，避免阻塞主线程
-                        .subscribeWith(new BaseObserver<AlbumSong>(mView) {
+                      .subscribeOn(Schedulers.io())
+                        // 将结果处理调度到主线程，方便更新 UI
+                      .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对结果进行观察和处理
+                      .subscribeWith(new BaseObserver<AlbumSong>(mView) {
+                            // 在网络请求开始时调用，用于显示加载状态
                             @Override
                             public void onStart() {
                                 mView.showLoading();
                             }
 
+                            // 当请求成功获取到结果时调用
                             @Override
                             public void onNext(AlbumSong albumSong) {
                                 super.onNext(albumSong);
+                                // 隐藏加载状态
                                 mView.hideLoading();
+                                // 如果获取的结果代码为 0，表示请求成功
                                 if (albumSong.getCode() == 0) {
+                                    // 根据类型进行不同的处理
                                     if (type == ALBUM_SONG) {
+                                        // 调用 insertAllAlbumSong 方法插入所有专辑歌曲
                                         insertAllAlbumSong(albumSong.getData().getList());
                                     } else {
+                                        // 调用视图的 showAlbumMessage 方法显示专辑信息
                                         mView.showAlbumMessage(
                                                 albumSong.getData().getName(),
                                                 albumSong.getData().getLan(),
@@ -53,18 +74,25 @@ public class AlbumSongPresenter extends BasePresenter<IAlbumSongContract.View> i
                                                 albumSong.getData().getDesc());
                                     }
                                 } else {
+                                    // 如果请求不成功，显示专辑歌曲错误
                                     mView.showAlbumSongError();
                                 }
                             }
 
+                            // 当请求发生错误时调用
                             @Override
                             public void onError(Throwable e) {
+                                // 打印错误栈信息
                                 e.printStackTrace();
+                                // 输出错误信息到日志
                                 Log.d(TAG, "onError: " + e.toString());
+                                // 隐藏加载状态
                                 mView.hideLoading();
+                                // 如果是网络异常且类型为 ALBUM_SONG，则显示网络错误
                                 if (e instanceof UnknownHostException && type == ALBUM_SONG) {
                                     mView.showNetError();
                                 } else {
+                                    // 否则显示专辑歌曲错误
                                     mView.showAlbumSongError();
                                 }
                             }
@@ -72,9 +100,12 @@ public class AlbumSongPresenter extends BasePresenter<IAlbumSongContract.View> i
         );
     }
 
+    // 实现 IAlbumSongContract.Presenter 接口中的 insertAllAlbumSong 方法，用于插入所有专辑歌曲
     @Override
     public void insertAllAlbumSong(List<AlbumSong.DataBean.ListBean> songList) {
+        // 调用 mModel 的 insertAllAlbumSong 方法将歌曲列表插入数据库，mModel 可能是在 BasePresenter 中声明的对象
         mModel.insertAllAlbumSong(songList);
+        // 调用视图的 setAlbumSongList 方法更新视图的专辑歌曲列表
         mView.setAlbumSongList(songList);
     }
 }

app/src/main/java/com/example/musicplayer/presenter/LocalPresenter.java

@@ -14,26 +14,41 @@ import java.util.List;
 
 /**
  * Created by 残渊 on 2018/10/17.
+ *
+ * <pre>
+ * 该类是一个本地音乐的 Presenter 类，继承自 BasePresenter 并实现了 ILocalContract.Presenter 接口。
+ * 主要负责处理本地音乐的相关业务逻辑，如获取本地 MP3 信息和保存本地歌曲。
+ * 它通过调用 mModel 的方法进行数据操作，并使用 EventBus 发送事件，
+ * 同时根据不同的操作结果更新视图或显示相应的信息。
+ * </pre>
  */
-
 public class LocalPresenter extends BasePresenter<ILocalContract.View> implements ILocalContract.Presenter {
 
+    // 实现 ILocalContract.Presenter 接口中的 getLocalMp3Info 方法，用于获取本地 MP3 信息
     @Override
     public void getLocalMp3Info() {
+        // 调用 mModel 的 getLocalMp3Info 方法获取本地歌曲列表，mModel 可能是在 BasePresenter 中声明的对象
         List<LocalSong> localSongList = mModel.getLocalMp3Info();
+        // 如果获取到的本地歌曲列表大小为 0，表示没有本地歌曲
         if(localSongList.size() == 0){
+            // 调用视图的 showErrorView 方法显示错误视图
             mView.showErrorView();
         }else {
+            // 否则调用 saveSong 方法保存本地歌曲
             saveSong(localSongList);
         }
-
     }
 
+    // 实现 ILocalContract.Presenter 接口中的 saveSong 方法，用于保存本地歌曲
     @Override
     public void saveSong(List<LocalSong> localSongs) {
+        // 调用 mModel 的 saveSong 方法保存本地歌曲，mModel 可能是在 BasePresenter 中声明的对象
         if(mModel.saveSong(localSongs)) {
+            // 如果保存成功，使用 EventBus 发送一个 SongListNumEvent 事件，类型为 Constant.LIST_TYPE_LOCAL
             EventBus.getDefault().post(new SongListNumEvent(Constant.LIST_TYPE_LOCAL));
+            // 调用视图的 showToast 方法显示成功导入本地音乐的提示
             mView.showToast("成功导入本地音乐");
+            // 调用视图的 showMusicList 方法显示音乐列表
             mView.showMusicList(localSongs);
         }
     }

app/src/main/java/com/example/musicplayer/presenter/PlayPresenter.java

@@ -21,133 +21,190 @@ import io.reactivex.schedulers.Schedulers;
 
 /**
  * Created by 残渊 on 2018/10/26.
+ *
+ * <pre>
+ * 该类是一个播放相关的 Presenter 类，继承自 BasePresenter 并实现了 IPlayContract.Presenter 接口。
+ * 主要负责处理播放相关的业务逻辑，如获取歌手图片、获取歌词、搜索歌曲、获取歌曲 ID、设置播放模式、查询和操作收藏歌曲等。
+ * 它使用 RxJava 进行异步操作，将网络请求调度到 IO 线程，将结果处理调度到主线程。
+ * 通过 RetrofitFactory 进行网络请求，使用 BaseObserver 处理请求结果和异常。
+ * </pre>
  */
-
 public class PlayPresenter extends BasePresenter<IPlayContract.View> implements IPlayContract.Presenter {
 
 
+    // 实现 IPlayContract.Presenter 接口中的 getSingerImg 方法，用于获取歌手图片
     @Override
     public void getSingerImg(String singer, String song, long duration) {
         addRxSubscribe(
+                // 通过 RetrofitFactory 创建请求服务并调用 getSingerImg 方法获取歌手图片
                 RetrofitFactory.createRequestOfSinger().getSingerImg(singer)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程
-                        .doOnNext(singerImg -> mView.setSingerImg(singerImg.getResult().getArtists().get(0).getImg1v1Url()))
+                     .subscribeOn(Schedulers.io())
-                        .doOnError(SingerImg -> mView.showToast("获取不到歌手图片"))
+                        // 将结果处理调度到主线程
-                        .observeOn(Schedulers.io())
+                     .observeOn(AndroidSchedulers.mainThread())
-                        .flatMap((Function<SingerImg, ObservableSource<SearchSong>>) singerImg -> RetrofitFactory.createRequest().search(song,1))
+                        // 当获取到歌手图片时，设置歌手图片到视图
-                        .observeOn(AndroidSchedulers.mainThread())
+                     .doOnNext(singerImg -> mView.setSingerImg(singerImg.getResult().getArtists().get(0).getImg1v1Url()))
-                        .subscribeWith(new BaseObserver<SearchSong>(mView) {
+                        // 当获取歌手图片出现错误时，显示错误信息
+                     .doOnError(SingerImg -> mView.showToast("获取不到歌手图片"))
+                        // 再次将后续操作调度到 IO 线程
+                     .observeOn(Schedulers.io())
+                        // 将获取歌手图片的操作结果转换为搜索歌曲的操作
+                     .flatMap((Function<SingerImg, ObservableSource<SearchSong>>) singerImg -> RetrofitFactory.createRequest().search(song, 1))
+                        // 将后续操作调度到主线程
+                     .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对搜索歌曲的结果进行观察和处理
+                     .subscribeWith(new BaseObserver<SearchSong>(mView) {
+                            // 当搜索歌曲成功时
                             @Override
                             public void onNext(SearchSong value) {
                                 super.onNext(value);
                                 if (value.getCode() == 0) {
-                                    matchLrc(value.getData().getSong().getList(),duration);
+                                    // 调用 matchLrc 方法匹配歌词
+                                    matchLrc(value.getData().getSong().getList(), duration);
                                 } else {
+                                    // 当搜索结果异常时，显示获取歌词错误
                                     mView.getLrcError(null);
                                 }
                             }
 
+                            // 当搜索歌曲出现错误时
                             @Override
                             public void onError(Throwable e) {
                                 super.onError(e);
+                                // 显示获取歌词错误
                                 mView.getLrcError(null);
                             }
                         })
         );
     }
 
+    // 实现 IPlayContract.Presenter 接口中的 getLrc 方法，用于获取歌词
     @Override
-    public void getLrc(String songId,int type) {
+    public void getLrc(String songId, int type) {
+        // 调用 mModel 的 getOnlineSongLrc 方法获取在线歌曲歌词，mModel 可能是在 BasePresenter 中声明的对象
         mModel.getOnlineSongLrc(songId)
-                .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                // 将网络请求操作调度到 IO 线程
-                .subscribeWith(new BaseObserver<OnlineSongLrc>(mView,false,false){
+             .subscribeOn(Schedulers.io())
+                // 将结果处理调度到主线程
+             .observeOn(AndroidSchedulers.mainThread())
+                // 使用 BaseObserver 对获取歌词的结果进行观察和处理
+             .subscribeWith(new BaseObserver<OnlineSongLrc>(mView, false, false) {
+                    // 当获取歌词成功时
                     @Override
-                    public void onNext(OnlineSongLrc onlineSongLrc){
+                    public void onNext(OnlineSongLrc onlineSongLrc) {
-                        if(onlineSongLrc.getCode() == 0){
+                        if (onlineSongLrc.getCode() == 0) {
                             String lrc = onlineSongLrc.getLyric();
-                            //如果是本地音乐，就将歌词保存起来
+                            // 如果是本地音乐，保存歌词
-                            if(type == Constant.SONG_LOCAL) mView.saveLrc(lrc);
+                            if (type == Constant.SONG_LOCAL) mView.saveLrc(lrc);
+                            // 显示歌词
                             mView.showLrc(lrc);
-                        }else {
+                        } else {
+                            // 当获取歌词失败时，显示获取歌词错误
                             mView.getLrcError(null);
                         }
                     }
                 });
     }
 
+    // 实现 IPlayContract.Presenter 接口中的 getSongId 方法，用于获取歌曲 ID
     @Override
     public void getSongId(String song, long duration) {
         addRxSubscribe(
+                // 调用 mModel 的 search 方法搜索歌曲
                 mModel.search(song, 1)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程
-                        .subscribeWith(new BaseObserver<SearchSong>(mView, true, true) {
+                     .subscribeOn(Schedulers.io())
+                        // 将结果处理调度到主线程
+                     .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对搜索结果进行观察和处理
+                     .subscribeWith(new BaseObserver<SearchSong>(mView, true, true) {
+                            // 当搜索成功时
                             @Override
                             public void onNext(SearchSong searchSong) {
                                 super.onNext(searchSong);
                                 if (searchSong.getCode() == 0) {
-                                    matchSong(searchSong.getData().getSong().getList(),duration);
+                                    // 调用 matchSong 方法匹配歌曲
+                                    matchSong(searchSong.getData().getSong().getList(), duration);
                                 } else {
+                                    // 当搜索结果异常时，显示获取歌词错误
                                     mView.getLrcError(null);
                                 }
                             }
-                        }));
+                        });
     }
 
+    // 实现 IPlayContract.Presenter 接口中的 setPlayMode 方法，用于设置播放模式
     @Override
     public void setPlayMode(int mode) {
+        // 调用 mModel 的 setPlayMode 方法设置播放模式，mModel 可能是在 BasePresenter 中声明的对象
         mModel.setPlayMode(mode);
     }
 
+    // 实现 IPlayContract.Presenter 接口中的 getPlayMode 方法，用于获取播放模式
     @Override
     public int getPlayMode() {
+        // 调用 mModel 的 getPlayMode 方法获取播放模式，mModel 可能是在 BasePresenter 中声明的对象
         return mModel.getPlayMode();
     }
 
 
+    // 实现 IPlayContract.Presenter 接口中的 queryLove 方法，用于查询歌曲是否被收藏
     @Override
     public void queryLove(String songId) {
+        // 调用 mView 的 showLove 方法显示歌曲是否被收藏，mView 是 IPlayContract.View 类型的视图对象
         mView.showLove(mModel.queryLove(songId));
     }
 
+    // 实现 IPlayContract.Presenter 接口中的 saveToLove 方法，用于将歌曲保存到收藏
     @Override
     public void saveToLove(Song song) {
-        if(mModel.saveToLove(song)){
+        // 调用 mModel 的 saveToLove 方法保存歌曲到收藏，mModel 可能是在 BasePresenter 中声明的对象
+        if (mModel.saveToLove(song)) {
+            // 当保存成功时，调用 mView 的 saveToLoveSuccess 方法显示保存成功信息
             mView.saveToLoveSuccess();
         }
     }
 
+    // 实现 IPlayContract.Presenter 接口中的 deleteFromLove 方法，用于从收藏中删除歌曲
     @Override
     public void deleteFromLove(String songId) {
-        if(mModel.deleteFromLove(songId)){
+        // 调用 mModel 的 deleteFromLove 方法从收藏中删除歌曲，mModel 可能是在 BasePresenter 中声明的对象
+        if (mModel.deleteFromLove(songId)) {
+            // 当删除成功时，调用 mView 的 sendUpdateCollection 方法更新收藏列表
             mView.sendUpdateCollection();
         }
     }
 
-    //匹配歌词
+    // 匹配歌词的私有方法
-    private void matchLrc(List<SearchSong.DataBean.SongBean.ListBean> listBeans,long duration){
+    private void matchLrc(List<SearchSong.DataBean.SongBean.ListBean> listBeans, long duration) {
         boolean isFind = false;
-        for(SearchSong.DataBean.SongBean.ListBean listBean:listBeans){
+        // 遍历搜索歌曲结果列表
-            if(duration == listBean.getInterval()){
+        for (SearchSong.DataBean.SongBean.ListBean listBean : listBeans) {
+            // 如果歌曲时长匹配，设置找到标志并设置歌曲 ID
+            if (duration == listBean.getInterval()) {
                 isFind = true;
                 mView.setLocalSongId(listBean.getSongmid());
             }
         }
-        //如果找不到歌曲id就传输找不到歌曲的消息
+        // 如果未找到匹配的歌曲，显示找不到歌曲 ID 的错误信息
-        if(!isFind) {
+        if (!isFind) {
             mView.getLrcError(Constant.SONG_ID_UNFIND);
         }
     }
 
-    private void matchSong(List<SearchSong.DataBean.SongBean.ListBean> listBeans,long duration){
+    // 匹配歌曲的私有方法
+    private void matchSong(List<SearchSong.DataBean.SongBean.ListBean> listBeans, long duration) {
         boolean isFind = false;
-        for(SearchSong.DataBean.SongBean.ListBean listBean:listBeans){
+        // 遍历搜索歌曲结果列表
-            if(duration == listBean.getInterval()){
+        for (SearchSong.DataBean.SongBean.ListBean listBean : listBeans) {
+            // 如果歌曲时长匹配，设置找到标志并获取歌曲成功
+            if (duration == listBean.getInterval()) {
                 isFind = true;
                 mView.getSongIdSuccess(listBean.getSongmid());
             }
         }
-        //如果找不到歌曲id就传输找不到歌曲的消息
+        // 如果未找到匹配的歌曲，显示找不到歌曲 ID 的错误信息
-        if(!isFind) {
+        if (!isFind) {
             mView.getLrcError(Constant.SONG_ID_UNFIND);
         }
     }

app/src/main/java/com/example/musicplayer/presenter/SearchContentPresenter.java

@@ -30,22 +30,37 @@ import okhttp3.Response;
 
 /**
  * Created by 残渊 on 2018/11/21.
+ *
+ * <pre>
+ * 该类是一个搜索内容的 Presenter 类，继承自 BasePresenter 并实现了 ISearchContentContract.Presenter 接口。
+ * 主要负责处理搜索相关的业务逻辑，包括搜索歌曲、搜索更多歌曲、搜索专辑、搜索更多专辑以及获取歌曲播放地址等操作。
+ * 它使用 RxJava 进行异步操作，将网络请求调度到 IO 线程，将结果处理调度到主线程，
+ * 并通过 BaseObserver 处理请求结果和异常，根据不同的结果更新视图。
+ * </pre>
  */
-
 public class SearchContentPresenter extends BasePresenter<ISearchContentContract.View>
         implements ISearchContentContract.Presenter {
+    // 用于日志输出的 TAG 常量，方便在日志中识别该类
     private static final String TAG = "SearchContentPresenter";
 
+    // 实现 ISearchContentContract.Presenter 接口中的 search 方法，用于搜索歌曲
     @Override
     public void search(String seek, int offset) {
         addRxSubscribe(
+                // 调用 mModel 的 search 方法进行搜索，mModel 可能是在 BasePresenter 中声明的对象
                 mModel.search(seek, offset)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程
-                        .subscribeWith(new BaseObserver<SearchSong>(mView, true, true) {
+                    .subscribeOn(Schedulers.io())
+                        // 将结果处理调度到主线程
+                    .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对搜索结果进行观察和处理
+                    .subscribeWith(new BaseObserver<SearchSong>(mView, true, true) {
+                            // 当搜索结果成功时
                             @Override
                             public void onNext(SearchSong searchSong) {
                                 super.onNext(searchSong);
                                 if (searchSong.getCode() == 0) {
+                                    // 将搜索结果中的歌曲列表设置到视图中
                                     mView.setSongsList((ArrayList<SearchSong.DataBean.SongBean.ListBean>)
                                             searchSong.getData().getSong().getList());
                                 }
@@ -53,12 +68,19 @@ public class SearchContentPresenter extends BasePresenter<ISearchContentContract
                         }));
     }
 
+    // 实现 ISearchContentContract.Presenter 接口中的 searchMore 方法，用于搜索更多歌曲
     @Override
     public void searchMore(String seek, int offset) {
         addRxSubscribe(
+                // 调用 mModel 的 search 方法进行搜索，mModel 可能是在 BasePresenter 中声明的对象
                 mModel.search(seek, offset)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程
-                        .subscribeWith(new BaseObserver<SearchSong>(mView, false, true) {
+                    .subscribeOn(Schedulers.io())
+                        // 将结果处理调度到主线程
+                    .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对搜索结果进行观察和处理
+                    .subscribeWith(new BaseObserver<SearchSong>(mView, false, true) {
+                            // 当搜索结果成功时
                             @Override
                             public void onNext(SearchSong searchSong) {
                                 super.onNext(searchSong);
@@ -66,90 +88,125 @@ public class SearchContentPresenter extends BasePresenter<ISearchContentContract
                                     ArrayList<SearchSong.DataBean.SongBean.ListBean> songListBeans =
                                             (ArrayList<SearchSong.DataBean.SongBean.ListBean>) searchSong.getData().getSong().getList();
                                     if (songListBeans.size() == 0) {
+                                        // 当搜索结果为空时，显示搜索更多错误
                                         mView.searchMoreError();
                                     } else {
+                                        // 当搜索结果不为空时，显示搜索更多成功并传递结果列表
                                         mView.searchMoreSuccess(songListBeans);
                                     }
                                 } else {
+                                    // 当搜索结果异常时，显示搜索更多错误
                                     mView.searchMoreError();
                                 }
                             }
 
+                            // 当搜索出现错误时
                             @Override
-                            public void onError(Throwable e){
+                            public void onError(Throwable e) {
                                 super.onError(e);
+                                // 显示搜索更多的网络错误
                                 mView.showSearcherMoreNetworkError();
                             }
                         }));
     }
 
 
+    // 实现 ISearchContentContract.Presenter 接口中的 searchAlbum 方法，用于搜索专辑
     @Override
     public void searchAlbum(String seek, int offset) {
         addRxSubscribe(
+                // 调用 mModel 的 searchAlbum 方法进行专辑搜索，mModel 可能是在 BasePresenter 中声明的对象
                 mModel.searchAlbum(seek, offset)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程
-                        .subscribeWith(new BaseObserver<Album>(mView, true, true) {
+                    .subscribeOn(Schedulers.io())
+                        // 将结果处理调度到主线程
+                    .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对搜索专辑结果进行观察和处理
+                    .subscribeWith(new BaseObserver<Album>(mView, true, true) {
+                            // 当搜索专辑结果成功时
                             @Override
                             public void onNext(Album album) {
                                 super.onNext(album);
                                 if (album.getCode() == 0) {
+                                    // 当搜索专辑结果正常时，显示搜索专辑成功并传递结果列表
                                     mView.searchAlbumSuccess(album.getData().getAlbum().getList());
                                 } else {
+                                    // 当搜索专辑结果异常时，显示搜索专辑错误
                                     mView.searchAlbumError();
                                 }
                             }
                         }));
     }
 
+    // 实现 ISearchContentContract.Presenter 接口中的 searchAlbumMore 方法，用于搜索更多专辑
     @Override
     public void searchAlbumMore(String seek, int offset) {
         addRxSubscribe(
+                // 调用 mModel 的 searchAlbum 方法进行专辑搜索，mModel 可能是在 BasePresenter 中声明的对象
                 mModel.searchAlbum(seek, offset)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程
-                        .subscribeWith(new BaseObserver<Album>(mView, false, true) {
+                    .subscribeOn(Schedulers.io())
+                        // 将结果处理调度到主线程
+                    .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对搜索专辑结果进行观察和处理
+                    .subscribeWith(new BaseObserver<Album>(mView, false, true) {
+                            // 当搜索专辑结果成功时
                             @Override
                             public void onNext(Album album) {
                                 super.onNext(album);
                                 if (album.getCode() == 0) {
+                                    // 当搜索专辑结果正常时，显示搜索更多专辑成功并传递结果列表
                                     mView.searchAlbumMoreSuccess(album.getData().getAlbum().getList());
                                 } else {
+                                    // 当搜索专辑结果异常时，显示搜索更多错误
                                     mView.searchMoreError();
                                 }
                             }
+
+                            // 当搜索专辑出现错误时
                             @Override
-                            public void onError(Throwable e){
+                            public void onError(Throwable e) {
                                 super.onError(e);
+                                // 显示搜索更多的网络错误
                                 mView.showSearcherMoreNetworkError();
                             }
                         }));
     }
 
+    // 实现 ISearchContentContract.Presenter 中的 getSongUrl 方法，用于获取歌曲播放地址
     @Override
     public void getSongUrl(Song song) {
+        // 输出日志，显示正在获取歌曲播放地址及相关数据
         Log.d(TAG, "getSongUrl: "+Api.SONG_URL_DATA_LEFT+song.getSongId()+Api.SONG_URL_DATA_RIGHT);
         addRxSubscribe(
+                // 通过 RetrofitFactory 创建请求服务并调用 getSongUrl 方法获取歌曲播放地址
                 RetrofitFactory.createRequestOfSongUrl().getSongUrl(Api.SONG_URL_DATA_LEFT+song.getSongId()+Api.SONG_URL_DATA_RIGHT)
-                        .subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread())
+                        // 将网络请求操作调度到 IO 线程
-                        .subscribeWith(new BaseObserver<SongUrl>(mView,false,false){
+                    .subscribeOn(Schedulers.io())
+                        // 将结果处理调度到主线程
+                    .observeOn(AndroidSchedulers.mainThread())
+                        // 使用 BaseObserver 对获取歌曲播放地址的结果进行观察和处理
+                    .subscribeWith(new BaseObserver<SongUrl>(mView,false,false){
+                            // 当获取歌曲播放地址成功时
                             @Override
-                            public void onNext(SongUrl songUrl){
+                            public void onNext(SongUrl songUrl) {
                                 super.onNext(songUrl);
-                                if(songUrl.getCode() == 0){
+                                if (songUrl.getCode() == 0) {
                                     String sip = songUrl.getReq_0().getData().getSip().get(0);
                                     String purl = songUrl.getReq_0().getData().getMidurlinfo().get(0).getPurl();
-                                    if(purl.equals("")){
+                                    if (purl.equals("")) {
+                                        // 当歌曲无版权时，显示提示信息
                                         mView.showToast("该歌曲暂时没有版权，搜搜其它歌曲吧");
-                                    }else {
+                                    } else {
-                                        mView.getSongUrlSuccess(song,sip+purl);
+                                        // 当获取播放地址成功时，调用视图的 getSongUrlSuccess 方法
+                                        mView.getSongUrlSuccess(song, sip + purl);
                                     }
-
+                                } else {
-                                }else {
+                                    // 当获取歌曲播放地址失败时，显示错误信息
                                     mView.showToast(songUrl.getCode()+":获取不到歌曲播放地址");
                                 }
                             }
                         })
         );
     }
-
 }

app/src/main/java/com/example/musicplayer/service/DownloadService.java

@@ -8,7 +8,6 @@ import android.app.Service;
 import android.content.Intent;
 import android.graphics.BitmapFactory;
 import android.os.Binder;
-import android.os.Build;
 import android.os.IBinder;
 import android.support.annotation.Nullable;
 import android.support.v4.app.NotificationCompat;
@@ -46,164 +45,225 @@ import static com.example.musicplayer.app.Constant.TYPE_DOWNLOADING;
  * <pre>
  *     author : 残渊
  *     time   : 2019/04/08
- *     desc   : 下载服务，保证DownloadTask在后台运行
+ *     desc   : 下载服务，保证 DownloadTask 在后台运行
+ * 
+ *     该类是一个服务类，用于处理歌曲的下载操作。
+ *     它使用 DownloadTask 进行下载任务的执行，通过 DownloadListener 监听下载进度和状态，
+ *     并使用 EventBus 进行事件的发布和订阅，以更新 UI 或通知其他部分下载的状态。
+ *     同时使用 LitePal 进行数据库操作，存储和更新下载信息。
+ *     还使用 Notification 进行通知的创建和更新，让用户了解下载的状态。
  * </pre>
  */
-
 public class DownloadService extends Service {
+    // 日志标签
     private static final String TAG = "DownloadService";
+    // 存储当前的下载任务
     private DownloadTask downloadTask;
+    // 存储下载的 URL
     private String downloadUrl;
+    // 自定义的 Binder 对象，用于与客户端通信
     private DownloadBinder downloadBinder = new DownloadBinder();
-    private LinkedList<DownloadInfo> downloadQueue = new LinkedList<>();//等待队列
+    // 存储下载等待队列，使用 LinkedList 方便在队列头部和尾部操作
-    private int position = 0;//下载歌曲在下载歌曲列表的位置
+    private LinkedList<DownloadInfo> downloadQueue = new LinkedList<>();
+    // 下载歌曲在下载歌曲列表中的位置
+    private int position = 0;
+    // 下载监听器，监听下载进度和状态
     private DownloadListener listener = new DownloadListener() {
+        // 下载进度更新时调用
         @Override
         public void onProgress(DownloadInfo downloadInfo) {
+            // 更新下载信息的状态为正在下载
             downloadInfo.setStatus(Constant.DOWNLOAD_ING);
-            EventBus.getDefault().post(new DownloadEvent(TYPE_DOWNLOADING, downloadInfo)); //通知下载模块
+            // 发布下载事件，通知下载模块
-            if(downloadInfo.getProgress()!=100){
+            EventBus.getDefault().post(new DownloadEvent(TYPE_DOWNLOADING, downloadInfo)); 
-                getNotificationManager().notify(1, getNotification("正在下载: "+downloadInfo.getSongName(), downloadInfo.getProgress()));
+            if (downloadInfo.getProgress()!= 100) {
-            }else {
+                // 更新通知显示正在下载及进度
-                if(downloadQueue.isEmpty()) getNotificationManager().notify(1, getNotification("下载成功",-1));
+                getNotificationManager().notify(1, getNotification("正在下载: " + downloadInfo.getSongName(), downloadInfo.getProgress()));
+            } else {
+                if (downloadQueue.isEmpty()) {
+                    // 当下载队列空且下载完成时，更新通知为下载成功
+                    getNotificationManager().notify(1, getNotification("下载成功", -1));
+                }
             }
-
         }
 
+        // 下载成功时调用
         @Override
         public void onSuccess() {
             downloadTask = null;
+            // 从下载队列中取出已完成的下载信息
             DownloadInfo downloadInfo = downloadQueue.poll();
-            operateDb(downloadInfo); //操作数据库
+            // 操作数据库，可能是更新下载信息等操作
-            start();//下载队列中的其它歌曲
+            operateDb(downloadInfo); 
-            //下载成功通知前台服务通知关闭，并创建一个下载成功的通知
+            // 开始下载队列中的下一个歌曲
+            start(); 
+            // 停止前台服务通知，并创建一个下载成功的通知
             stopForeground(true);
-            if(downloadQueue.isEmpty()) getNotificationManager().notify(1, getNotification("下载成功",-1));
+            if (downloadQueue.isEmpty()) {
+                getNotificationManager().notify(1, getNotification("下载成功", -1));
+            }
         }
 
+        // 下载完成时调用
         @Override
         public void onDownloaded() {
             downloadTask = null;
+            // 显示下载完成的 Toast 提示
             CommonUtil.showToast(DownloadService.this, "已下载");
         }
 
+        // 下载失败时调用
         @Override
         public void onFailed() {
             downloadTask = null;
-
+            // 停止前台服务通知，并创建一个下载失败的通知
-            //下载失败通知前台服务通知关闭，并创建一个下载失败的通知
             stopForeground(true);
-            getNotificationManager().notify(1, getNotification("下载失败",-1));
+            getNotificationManager().notify(1, getNotification("下载失败", -1));
+            // 显示下载失败的 Toast 提示
             Toast.makeText(DownloadService.this, "下载失败", Toast.LENGTH_SHORT).show();
         }
 
+        // 下载暂停时调用
         @Override
         public void onPaused() {
             downloadTask = null;
-            DownloadInfo downloadInfo=downloadQueue.poll();//从下载列表中移除该歌曲
+            // 从下载队列中移除暂停的歌曲
+            DownloadInfo downloadInfo = downloadQueue.poll(); 
+            // 更新数据库中暂停的歌曲状态
             updateDbOfPause(downloadInfo.getSongId());
-            getNotificationManager().notify(1, getNotification("下载已暂停："+downloadInfo.getSongName(), -1));
+            // 更新通知为下载已暂停
-            start();//下载下载列表中的歌曲
+            getNotificationManager().notify(1, getNotification("下载已暂停：" + downloadInfo.getSongName(), -1));
+            // 开始下载队列中的下一个歌曲
+            start(); 
+            // 更新下载信息状态为暂停，并发布暂停事件
             downloadInfo.setStatus(Constant.DOWNLOAD_PAUSED);
-            EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_PAUSED, downloadInfo)); //下载暂停
+            EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_PAUSED, downloadInfo)); 
+            // 显示下载已暂停的 Toast 提示
             Toast.makeText(DownloadService.this, "下载已暂停", Toast.LENGTH_SHORT).show();
         }
 
+        // 下载取消时调用
         @Override
         public void onCanceled() {
             downloadTask = null;
+            // 停止前台服务通知
             stopForeground(true);
+            // 显示下载已取消的 Toast 提示
             Toast.makeText(DownloadService.this, "下载已取消", Toast.LENGTH_SHORT).show();
         }
     };
 
+    // 服务绑定方法，返回 Binder 对象
     @Nullable
     @Override
     public IBinder onBind(Intent intent) {
         return downloadBinder;
     }
 
+    // 自定义的 Binder 类，用于与客户端通信
     public class DownloadBinder extends Binder {
+        // 开始下载方法
         public void startDownload(DownloadInfo song) {
             try {
-                postDownloadEvent(song);//通知正在下载界面
+                // 通知正在下载界面
+                postDownloadEvent(song); 
             } catch (Exception e) {
                 e.printStackTrace();
             }
-            if (downloadTask != null) {
+            if (downloadTask!= null) {
+                // 已存在下载任务时的提示
                 CommonUtil.showToast(DownloadService.this, "已经加入下载队列");
             } else {
+                // 开始下载的提示
                 CommonUtil.showToast(DownloadService.this, "开始下载");
                 start();
             }
         }
 
+        // 暂停下载方法
         public void pauseDownload(String songId) {
-            //暂停的歌曲是否为当前下载的歌曲
+            // 判断暂停的歌曲是否为当前正在下载的歌曲
-            if (downloadTask != null &&downloadQueue.peek().getSongId().equals(songId)) {
+            if (downloadTask!= null && downloadQueue.peek().getSongId().equals(songId)) {
+                // 暂停当前下载任务
                 downloadTask.pauseDownload();
-            }else {//暂停的歌曲是下载队列的歌曲
+            } else {
-                //将该歌曲从下载队列中移除
+                // 暂停的歌曲在下载队列中
                 for (int i = 0; i < downloadQueue.size(); i++) {
                     DownloadInfo downloadInfo = downloadQueue.get(i);
                     if (downloadInfo.getSongId().equals(songId)) {
+                        // 从下载队列中移除该歌曲
                         downloadQueue.remove(i);
+                        // 更新数据库中该歌曲的暂停状态
                         updateDbOfPause(downloadInfo.getSongId());
+                        // 更新下载信息状态为暂停，并发布暂停事件
                         downloadInfo.setStatus(Constant.DOWNLOAD_PAUSED);
-                        EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_PAUSED, downloadInfo)); //下载暂停
+                        EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_PAUSED, downloadInfo)); 
                     }
                 }
             }
         }
 
 
+        // 取消下载方法
         public void cancelDownload(DownloadInfo song) {
             String songId = song.getSongId();
-            //如果该歌曲正在下载，则需要将downloadTask置为null
+            // 如果该歌曲正在下载，取消下载任务
-            if (downloadTask != null && downloadQueue.peek().getSongId().equals(songId)) {
+            if (downloadTask!= null && downloadQueue.peek().getSongId().equals(songId)) {
                 downloadTask.cancelDownload();
             }
-            //将该歌曲从下载队列中移除
+            // 将该歌曲从下载队列中移除
             for (int i = 0; i < downloadQueue.size(); i++) {
                 DownloadInfo downloadInfo = downloadQueue.get(i);
                 if (downloadInfo.getSongId().equals(songId)) downloadQueue.remove(i);
             }
+            // 更新数据库
             updateDb(songId);
+            // 删除数据库中的该歌曲信息
             deleteDb(songId);
-            //取消下载需要将文件删除并将通知关闭
+            // 取消下载需要将文件删除并关闭通知
-            if (song.getUrl() != null) {
+            if (song.getUrl()!= null) {
-                checkoutFile(song,song.getUrl()); //实际文件长度
+                checkoutFile(song, song.getUrl()); 
             }
-            //通知正在下载列表
+            // 发布下载取消事件
             EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_CANCELED));
-
         }
-
     }
+
+    // 开始下载的方法
     private void start() {
-        if (downloadTask == null && !downloadQueue.isEmpty()) {
+        if (downloadTask == null &&!downloadQueue.isEmpty()) {
+            // 从下载队列中取出要下载的歌曲信息
             DownloadInfo downloadInfo = downloadQueue.peek();
+            // 从数据库中查找该歌曲信息
             List<DownloadInfo> songList =
-                    LitePal.where("songId = ?",downloadInfo.getSongId()).find(DownloadInfo.class);
+                    LitePal.where("songId =?", downloadInfo.getSongId()).find(DownloadInfo.class);
             DownloadInfo currentDownloadInfo = songList.get(0);
+            // 更新歌曲状态为准备下载
             currentDownloadInfo.setStatus(Constant.DOWNLOAD_READY);
-            EventBus.getDefault().post(new DownloadEvent(TYPE_DOWNLOADING,currentDownloadInfo));
+            // 发布下载事件
+            EventBus.getDefault().post(new DownloadEvent(TYPE_DOWNLOADING, currentDownloadInfo));
             downloadUrl = currentDownloadInfo.getUrl();
+            // 创建新的下载任务并执行
             downloadTask = new DownloadTask(listener);
             downloadTask.execute(currentDownloadInfo);
-            getNotificationManager().notify(1, getNotification("正在下载："+downloadInfo.getSongName(), 0));
+            // 更新通知为正在下载
+            getNotificationManager().notify(1, getNotification("正在下载：" + downloadInfo.getSongName(), 0));
         }
     }
 
 
+    // 获取通知管理器
     private NotificationManager getNotificationManager() {
         return (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
     }
 
-    private Notification getNotification(String title,int progress) {
+    // 创建通知的方法
+    private Notification getNotification(String title, int progress) {
+        // 创建跳转到主界面的意图
         Intent intent = new Intent(this, MainActivity.class);
         PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0);
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            // 创建通知通道
             String id = "channel_001";
             String name = "下载通知";
             NotificationChannel mChannel = new NotificationChannel(id, name, NotificationManager.IMPORTANCE_LOW);
@@ -212,107 +272,132 @@ public class DownloadService extends Service {
             builder.setSmallIcon(R.mipmap.icon);
             builder.setContentIntent(pi);
             builder.setContentTitle(title);
-            if(progress>0){
+            if (progress > 0) {
-                builder.setContentText(progress +"%");
+                builder.setContentText(progress + "%");
                 builder.setProgress(100, progress, false);
             }
             return builder.build();
         } else {
+            // 兼容旧版本的通知创建
             NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "default");
             builder.setSmallIcon(R.mipmap.icon);
             builder.setLargeIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.icon));
             builder.setContentIntent(pi);
             builder.setContentTitle(title);
-            if(progress>0){
+            if (progress > 0) {
-                builder.setContentText(progress +"%");
+                builder.setContentText(progress + "%");
                 builder.setProgress(100, progress, false);
             }
             return builder.build();
         }
     }
 
+    // 操作数据库的方法，可能是下载成功后的操作
     private void operateDb(DownloadInfo downloadInfo) {
         updateDb(downloadInfo.getSongId());
         deleteDb(downloadInfo.getSongId());
-        EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_SUCCESS));//通知已下载列表
+        // 发布下载成功事件
-        EventBus.getDefault().post(new SongListNumEvent(Constant.LIST_TYPE_DOWNLOAD)); //通知主界面的下载个数需要改变
+        EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_SUCCESS)); 
+        // 发布歌曲列表数量改变事件
+        EventBus.getDefault().post(new SongListNumEvent(Constant.LIST_TYPE_DOWNLOAD)); 
     }
 
-    //更新数据库中歌曲列表的位置，即下载完成歌曲后的位置都要减去1；
+    // 更新数据库中歌曲列表的位置
     private void updateDb(String songId) {
-        long id = LitePal.select("id").where("songId = ?", songId).find(DownloadInfo.class).get(0).getId();
+        // 查找该歌曲在数据库中的 ID
-        List<DownloadInfo> songIdList = LitePal.where("id > ?", id + "").find(DownloadInfo.class);
+        long id = LitePal.select("id").where("songId =?", songId).find(DownloadInfo.class).get(0).getId();
+        // 查找该歌曲之后的歌曲列表
+        List<DownloadInfo> songIdList = LitePal.where("id >?", id + "").find(DownloadInfo.class);
         for (DownloadInfo song : songIdList) {
+            // 更新位置，将后续歌曲位置减 1
             song.setPosition(song.getPosition() - 1);
             song.save();
         }
     }
 
-    //暂停时更新列表歌曲状态
+    // 暂停时更新数据库中歌曲的状态
-    private void updateDbOfPause(String songId){
+    private void updateDbOfPause(String songId) {
         List<DownloadInfo> statusList =
-                LitePal.where("songId = ?",songId).find(DownloadInfo.class,true);
+                LitePal.where("songId =?", songId).find(DownloadInfo.class, true);
         DownloadInfo downloadInfo = statusList.get(0);
         downloadInfo.setStatus(Constant.DOWNLOAD_PAUSED);
         downloadInfo.save();
     }
 
-    //下载完成时要删除下载歌曲表中的数据以及关联表中的数据
+    // 下载完成时删除数据库中的数据
     private void deleteDb(String songId) {
-        LitePal.deleteAll(DownloadInfo.class, "songId=?", songId);//删除已下载歌曲的相关列
+        // 删除已下载歌曲的相关列
+        LitePal.deleteAll(DownloadInfo.class, "songId=?", songId); 
     }
 
+    // 发布下载事件
     private void postDownloadEvent(DownloadInfo downloadInfo) {
-        //如果需要下载的表中有该条歌曲，则添加到下载队列后跳过
+        // 检查数据库中是否已存在该歌曲的下载信息
         List<DownloadInfo> downloadInfoList =
-                LitePal.where("songId = ?",downloadInfo.getSongId()).find(DownloadInfo.class,true);
+                LitePal.where("songId =?", downloadInfo.getSongId()).find(DownloadInfo.class, true);
-        if (downloadInfoList.size() != 0){
+        if (downloadInfoList.size()!= 0) {
             DownloadInfo historyDownloadInfo = downloadInfoList.get(0);
+            // 更新状态为等待
             historyDownloadInfo.setStatus(Constant.DOWNLOAD_WAIT);
             historyDownloadInfo.save();
-            EventBus.getDefault().post(new DownloadEvent(Constant.DOWNLOAD_PAUSED,historyDownloadInfo));
+            // 发布暂停事件
+            EventBus.getDefault().post(new DownloadEvent(Constant.DOWNLOAD_PAUSED, historyDownloadInfo));
+            // 将歌曲添加到下载队列
             downloadQueue.offer(historyDownloadInfo);
             return;
         }
-
+        // 设置歌曲在下载列表中的位置
         position = LitePal.findAll(DownloadInfo.class).size();
         downloadInfo.setPosition(position);
-        downloadInfo.setStatus(Constant.DOWNLOAD_WAIT); //等待
+        downloadInfo.setStatus(Constant.DOWNLOAD_WAIT); 
         downloadInfo.save();
-        downloadQueue.offer(downloadInfo);//将歌曲放到等待队列中
+        // 将歌曲添加到等待队列
+        downloadQueue.offer(downloadInfo); 
+        // 发布添加下载事件
         EventBus.getDefault().post(new DownloadEvent(Constant.TYPE_DOWNLOAD_ADD));
     }
 
 
-    //获取歌曲实际大小，然后判断是否存在于文件中
+    // 获取歌曲实际大小，并判断文件是否存在，可能用于取消下载时的清理
-    public void checkoutFile(DownloadInfo song, String downloadUrl){
+public void checkoutFile(DownloadInfo song, String downloadUrl) {
-            OkHttpClient client = new OkHttpClient();
+    // 创建 OkHttpClient 实例，用于网络请求
-            Request request = new Request.Builder()
+    OkHttpClient client = new OkHttpClient();
-                    .url(downloadUrl)
+    // 构建请求对象，指定请求的 URL
-                    .build();
+    Request request = new Request.Builder()
-                Call call= client.newCall(request);
+          .url(downloadUrl)
-                call.enqueue(new Callback() {
+          .build();
-                    @Override
+    // 创建一个 Call 对象，用于执行请求
-                    public void onFailure(Call call, IOException e) {
+    Call call = client.newCall(request);
-
+    // 将请求加入请求队列，并设置回调
-                    }
+    call.enqueue(new Callback() {
-
+        // 请求失败时调用
-                    @Override
+        @Override
-                    public void onResponse(Call call, Response response) throws IOException {
+        public void onFailure(Call call, IOException e) {
-                        if(response.isSuccessful()){
+            // 此处暂时未处理请求失败的情况，可以根据需求添加相应的处理逻辑
-                            long size = response.body().contentLength();
+        }
-                            String fileName = DownloadUtil.getSaveSongFile(song.getSinger(),song.getSongName(),song.getDuration(),song.getSongId(),size);
-                            File downloadFile = new File(Api.STORAGE_SONG_FILE);
-                            String directory = String.valueOf(downloadFile);
-                            File file = new File(fileName, directory);
-                            if (file.exists()) {
-                                file.delete();
-                            }
-                            getNotificationManager().cancel(1);
-                            stopForeground(true);
-                        }
-                    }
-                });
-    }
 
+        // 请求成功时调用
+        @Override
+        public void onResponse(Call call, Response response) throws IOException {
+            if (response.isSuccessful()) {
+                // 获取响应体的内容长度，即文件的实际大小
+                long size = response.body().contentLength();
+                // 根据歌曲信息和文件大小生成保存歌曲的文件名
+                String fileName = DownloadUtil.getSaveSongFile(song.getSinger(), song.getSongName(), song.getDuration(), song.getSongId(), size);
+                // 获取存储歌曲文件的目录
+                File downloadFile = new File(Api.STORAGE_SONG_FILE);
+                String directory = String.valueOf(downloadFile);
+                // 构建文件对象
+                File file = new File(fileName, directory);
+                if (file.exists()) {
+                    // 如果文件存在，删除文件
+                    file.delete();
+                }
+                // 取消通知
+                getNotificationManager().cancel(1);
+                // 停止服务的前台运行状态
+                stopForeground(true);
+            }
+        }
+    });
 }

app/src/main/java/com/example/musicplayer/util/CommonUtil.java

@@ -28,164 +28,173 @@ import com.example.musicplayer.app.App;
 
 /**
  * Created by 残渊 on 2018/10/26.
+ * 通用的工具类，包含多个实用方法，可在整个应用中使用
  */
-
-//通用的工具类
 public class CommonUtil {
+    // 存储 Toast 实例，避免重复创建
     private static Toast toast;
 
+    // 控制活动的状态栏显示或隐藏
     public static void hideStatusBar(Activity activity, boolean isHide) {
+        // 获取活动的根视图
         View decorView = activity.getWindow().getDecorView(); 
         if (isHide) {
             if (Build.VERSION.SDK_INT >= 22) {
-
+                // 隐藏状态栏并使布局扩展到状态栏区域，状态栏透明
                 decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN |
                         View.SYSTEM_UI_FLAG_LAYOUT_STABLE); 
                 activity.getWindow().setStatusBarColor(Color.TRANSPARENT); 
             }
         } else {
+            // 显示状态栏并设置状态栏颜色
             decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE); 
             activity.getWindow().setStatusBarColor(App.getContext().getResources().getColor(R.color.actionBarColor)); 
         }
     }
 
-    //
+    // 显示 Toast 消息
     @SuppressLint("ShowToast")
     public static void showToast(Context context, String message) {
         if (toast == null) {
+            // 创建一个新的 Toast 实例
             toast = Toast.makeText(context, message, Toast.LENGTH_SHORT); 
         } else {
+            // 更新 Toast 的消息内容
             toast.setText(message); 
         }
+        // 显示 Toast
         toast.show(); 
     }
 
-    /**
+    // 获取屏幕的宽度
-     * 得到屏幕的宽度
-     */
     public static int getScreenWidth(Context context) {
         if (null == context) {
             return 0;
         }
+        // 获取屏幕的宽度像素值
         return context.getResources().getDisplayMetrics().widthPixels; 
     }
 
-    /**
+    // 获取屏幕的高度
-     * 得到屏幕的高度
-     */
-
     public static int getScreenHeight(Context context) {
         if (null == context) {
             return 0;
         }
+        // 获取屏幕的高度像素值
         return context.getResources().getDisplayMetrics().heightPixels; 
     }
 
-    /**
+    // 使 EditText 获取焦点并显示软键盘
-     * EditText获取焦点并显示软键盘
-     */
-    //弹出软键盘
     public static void showKeyboard(EditText editText, Context context) {
-        //其中editText为dialog中的输入框的 EditText
+        if (editText!= null) {
-        if (editText != null) {
+            // 使 EditText 可获得焦点
-            //设置可获得焦点
             editText.setFocusable(true); 
             editText.setFocusableInTouchMode(true); 
-            //请求获得焦点
+            // 请求获得焦点
             editText.requestFocus(); 
-            //调用系统输入法
+            // 获取输入法管理器
             InputMethodManager inputManager = (InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE); 
-            inputManager.toggleSoftInput(0,InputMethodManager.HIDE_NOT_ALWAYS);
+            // 显示软键盘
+            inputManager.toggleSoftInput(0, InputMethodManager.HIDE_NOT_ALWAYS); 
         }
     }
 
-    /**
+    // 关闭软键盘
-     * 关闭软键盘
-     *
-     * @param mEditText 输入框
-     * @param context   上下文
-     */
     public static void closeKeybord(EditText mEditText, Context context) {
+        // 清除 EditText 的焦点
         mEditText.clearFocus(); 
+        // 获取输入法管理器
         InputMethodManager imm = (InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE); 
+        // 隐藏软键盘
         imm.hideSoftInputFromWindow(mEditText.getWindowToken(), 0); 
     }
 
-    /**
+    // 使指定字符串在 TextView 中显示不同颜色
-     * 使指定的字符串显示不同的颜色
-     */
     public static void showStringColor(String appointStr, String originalStr, TextView textView) {
+        // 将原始字符串中的指定字符串替换为带有颜色标记的 HTML 字符串
         originalStr = originalStr.replaceAll(appointStr, "<font color='#FFC66D'>" + appointStr + "</font>"); 
+        // 使用 Html.fromHtml 将 HTML 字符串转换为 Spanned 并设置到 TextView 中
         textView.setText(Html.fromHtml(originalStr)); 
     }
 
-    //获取状态栏高度
+    // 获取状态栏的高度
     public static int getStatusHeightPx(Activity act) {
         int height = 0;
+        // 获取状态栏高度资源的标识符
         int resourceId = act.getResources().getIdentifier("status_bar_height", "dimen", "android"); 
         if (resourceId > 0) {
+            // 获取状态栏的高度像素值
             height = act.getResources().getDimensionPixelSize(resourceId); 
         }
         return height;
     }
-    //高斯模糊
+
+    // 生成前景模糊的 Drawable
     public static Drawable getForegroundDrawable(Bitmap bitmap) {
-        /*得到屏幕的宽高比，以便按比例切割图片一部分*/
+        // 计算屏幕宽高比
         final float widthHeightSize = (float) (DisplayUtil.getScreenWidth(App.getContext())
                 * 1.0 / DisplayUtil.getScreenHeight(App.getContext()) * 1.0); 
-
+        // 计算裁剪图片的宽度
         int cropBitmapWidth = (int) (widthHeightSize * bitmap.getHeight()); 
         int cropBitmapWidthX = (int) ((bitmap.getWidth() - cropBitmapWidth) / 2.0); 
-
+        // 裁剪部分图片
-        /*切割部分图片*/
         Bitmap cropBitmap = Bitmap.createBitmap(bitmap, cropBitmapWidthX, 0, cropBitmapWidth,
                 bitmap.getHeight()); 
-        /*缩小图片*/
+        // 缩小图片
         Bitmap scaleBitmap = Bitmap.createScaledBitmap(cropBitmap, bitmap.getWidth() / 50, bitmap
-                .getHeight() / 50, false);
+               .getHeight() / 50, false); 
-        /*模糊化*/
+        // 对缩小后的图片进行模糊处理
         final Bitmap blurBitmap = FastBlurUtil.doBlur(scaleBitmap, 3, true); 
-
+        // 创建模糊后的 Drawable
         final Drawable foregroundDrawable = new BitmapDrawable(blurBitmap); 
-        /*加入灰色遮罩层，避免图片过亮影响其他控件*/
+        // 可添加灰色遮罩层（未实现）
-
         return foregroundDrawable; 
     }
 
-    public static Bitmap getImgBitmap(Context context,String imgUrl){
+    // 使用 Glide 加载图片并获取其 Bitmap
+    public static Bitmap getImgBitmap(Context context, String imgUrl) {
         SimpleTarget target = new SimpleTarget<Drawable>(Target.SIZE_ORIGINAL, Target.SIZE_ORIGINAL) {
             @Override
             public void onResourceReady(@Nullable Drawable resource, Transition<? super Drawable> transition) {
+                // 当资源加载完成时，将 Drawable 转换为 Bitmap
                 Bitmap bitmap = ((BitmapDrawable) resource).getBitmap(); 
             }
         };
+        // 使用 Glide 加载图片，设置占位符和错误图片
         Glide.with(context)
-                .load(imgUrl)
+              .load(imgUrl)
-                .apply(RequestOptions.placeholderOf(R.drawable.welcome))
+              .apply(RequestOptions.placeholderOf(R.drawable.welcome))
-                .apply(RequestOptions.errorOf(R.drawable.welcome))
+              .apply(RequestOptions.errorOf(R.drawable.welcome))
-                .into(target);
+              .into(target); 
+        // 此方法始终返回 null，可能需要修改
         return null; 
     }
-    public static void setImgWithGlide(Context context,String imgUrl,ImageView view){
+
+    // 使用 Glide 加载图片到 ImageView
+    public static void setImgWithGlide(Context context, String imgUrl, ImageView view) {
+        // 使用 Glide 加载图片，设置占位符和错误图片
         Glide.with(context)
-                .load(imgUrl)
+              .load(imgUrl)
-                .apply(RequestOptions.placeholderOf(R.drawable.welcome))
+              .apply(RequestOptions.placeholderOf(R.drawable.welcome))
-                .apply(RequestOptions.errorOf(R.drawable.love))
+              .apply(RequestOptions.errorOf(R.drawable.love))
-                .into(view);
+              .into(view); 
     }
-    public static void setSingerImg (Context context, String singer, ImageView view) {
+
-        if(singer.contains("/")){
+    // 根据歌手信息加载歌手图片到 ImageView
-            String[] s=singer.split("/");
+    public static void setSingerImg(Context context, String singer, ImageView view) {
-            singer=s[0];
+        if (singer.contains("/")) {
+            // 处理歌手名字中包含斜杠的情况
+            String[] s = singer.split("/"); 
+            singer = s[0]; 
         }
-        singer=singer.trim();
+        singer = singer.trim(); 
+        // 构建歌手图片的 URL
         String imgUrl = Api.STORAGE_IMG_FILE + singer + ".jpg"; 
-
+        // 使用 Glide 加载图片，设置占位符和错误图片
         Glide.with(context)
-                .load(imgUrl)
+              .load(imgUrl)
-                .apply(RequestOptions.placeholderOf(R.drawable.welcome))
+              .apply(RequestOptions.placeholderOf(R.drawable.welcome))
-                .apply(RequestOptions.errorOf(R.drawable.welcome))
+              .apply(RequestOptions.errorOf(R.drawable.welcome))
-                .into(view);
+              .into(view); 
     }
-
 }

app/src/main/java/com/example/musicplayer/util/DisplayUtil.java

@@ -4,18 +4,18 @@ import android.content.Context;
 
 /**
  * Created by 残渊 on 2018/10/27.
+ * 该类包含了一些与显示相关的常量和方法，主要用于处理与屏幕尺寸相关的比例计算和屏幕尺寸获取
  */
-
 public class DisplayUtil {
 
-    /*手柄起始角度*/
+    /* 手柄起始角度，可能用于旋转动画等操作，初始角度为 -30 度 */
     public static final float ROTATION_INIT_NEEDLE = -30;
 
-    /*截图屏幕宽高*/
+    /* 基准屏幕的宽度和高度，作为比例计算的基础 */
     private static final float BASE_SCREEN_WIDTH = (float) 1080.0;
     private static final float BASE_SCREEN_HEIGHT = (float) 1920.0;
 
-    /*唱针宽高、距离等比例*/
+    /* 唱针的各种比例相关的常量，可能用于布局调整或动画计算 */
     public static final float SCALE_NEEDLE_WIDTH = (float) (276.0 / BASE_SCREEN_WIDTH);
     public static final float SCALE_NEEDLE_MARGIN_LEFT = (float) (500.0 / BASE_SCREEN_WIDTH);
     public static final float SCALE_NEEDLE_PIVOT_X = (float) (43.0 / BASE_SCREEN_WIDTH);
@@ -23,19 +23,19 @@ public class DisplayUtil {
     public static final float SCALE_NEEDLE_HEIGHT = (float) (413.0 / BASE_SCREEN_HEIGHT);
     public static final float SCALE_NEEDLE_MARGIN_TOP = (float) (43.0 / BASE_SCREEN_HEIGHT);
 
-    /*唱盘比例*/
+    /* 唱盘的比例，可能用于布局调整，确定唱盘的大小和位置 */
     public static final float SCALE_DISC_SIZE = (float) (813.0 / BASE_SCREEN_WIDTH);
     public static final float SCALE_DISC_MARGIN_TOP = (float) (190 / BASE_SCREEN_HEIGHT);
 
-    /*专辑图片比例*/
+    /* 专辑图片的比例，可能用于布局调整，确定专辑图片的大小 */
     public static final float SCALE_MUSIC_PIC_SIZE = (float) (533.0 / BASE_SCREEN_WIDTH);
 
-    /*设备屏幕宽度*/
+    /* 获取设备屏幕的宽度，以像素为单位 */
     public static int getScreenWidth(Context context) {
         return context.getResources().getDisplayMetrics().widthPixels;
     }
 
-    /*设备屏幕高度*/
+    /* 获取设备屏幕的高度，以像素为单位 */
     public static int getScreenHeight(Context context) {
         return context.getResources().getDisplayMetrics().heightPixels;
     }

app/src/main/java/com/example/musicplayer/util/DownloadUtil.java

@@ -18,55 +18,80 @@ import static com.example.musicplayer.app.Api.STORAGE_SONG_FILE;
  *     desc   : 下载相关工具
  * </pre>
  */
-
 public class DownloadUtil {
     /**
-     *
+     * 从文件中获取已下载的歌曲列表
-     * @param fileName 文件跟目录
+     * @param fileName 文件根目录
-     * @return 得到已下载的歌曲
+     * @return 包含已下载歌曲的列表
      */
-    public static final List<DownloadSong> getSongFromFile(String fileName){
+    public static final List<DownloadSong> getSongFromFile(String fileName) {
-        //将.m4a截取掉得到singer-songName-duration-songId-size
+        // 存储已下载歌曲的列表
         List<DownloadSong> res = new ArrayList<>(); 
-        File file=new File(fileName);
+        // 创建文件对象
-        if(!file.exists()){
+        File file = new File(fileName); 
+        // 如果文件不存在，创建该目录
+        if (!file.exists()) { 
             file.mkdirs(); 
             return res; 
         }
+        // 获取目录下的所有文件
         File[] subFile = file.listFiles(); 
         for (File value : subFile) { 
+            // 获取文件名
             String songFileName = value.getName(); 
+            // 去掉文件后缀名
             String songFile = songFileName.substring(0, songFileName.lastIndexOf(".")); 
+            // 将文件名按 - 分割
             String[] songValue = songFile.split("-"); 
+            // 获取文件大小
             long size = Long.valueOf(songValue[4]); 
-            //如果文件的大小不等于实际大小，则表示该歌曲还未下载完成，被人为暂停，故跳过该歌曲，不加入到已下载集合
+            // 如果文件大小不等于实际文件大小，说明歌曲未下载完成，跳过该文件
-            if(size != value.length()) continue;
+            if (size!= value.length()) continue; 
+            // 创建 DownloadSong 对象
             DownloadSong downloadSong = new DownloadSong(); 
+            // 设置歌手信息
             downloadSong.setSinger(songValue[0]); 
+            // 设置歌曲名称
             downloadSong.setName(songValue[1]); 
+            // 设置歌曲时长
             downloadSong.setDuration(Long.valueOf(songValue[2])); 
+            // 设置歌曲 ID
             downloadSong.setSongId(songValue[3]); 
+            // 设置歌曲的 URL
             downloadSong.setUrl(fileName + songFileName); 
+            // 将 DownloadSong 对象添加到结果列表中
             res.add(downloadSong); 
         }
         return res; 
     }
 
-    public static final boolean isExistOfDownloadSong(String songId){
+    /**
-        //将.m4a截取掉得到singer-songName-duration-songId-size
+     * 判断歌曲是否已下载完成
-        File file=new File(STORAGE_SONG_FILE);
+     * @param songId 歌曲的 ID
-        if(!file.exists()){
+     * @return 歌曲是否已下载完成
+     */
+    public static final boolean isExistOfDownloadSong(String songId) {
+        // 创建文件对象，使用 STORAGE_SONG_FILE 作为文件根目录
+        File file = new File(STORAGE_SONG_FILE); 
+        // 如果文件不存在，创建该目录
+        if (!file.exists()) { 
             file.mkdirs(); 
             return false; 
         }
+        // 获取目录下的所有文件
         File[] subFile = file.listFiles(); 
         for (File value : subFile) { 
+            // 获取文件名
             String songFileName = value.getName(); 
+            // 去掉文件后缀名
             String songFile = songFileName.substring(0, songFileName.lastIndexOf(".")); 
+            // 将文件名按 - 分割
             String[] songValue = songFile.split("-"); 
-            //如果文件的大小不等于实际大小，则表示该歌曲还未下载完成，被人为暂停，故跳过该歌曲，不加入到已下载集合
+            // 如果歌曲 ID 匹配
-            if(songValue[3].equals(songId)) {
+            if (songValue[3].equals(songId)) { 
+                // 获取文件大小
                 long size = Long.valueOf(songValue[4]); 
+                // 判断文件大小是否等于实际文件大小，如果相等表示已下载完成
                 return size == value.length(); 
             }
         }
@@ -74,8 +99,9 @@ public class DownloadUtil {
     }
 
 
-    //组装下载歌曲的文件名
+    // 组装下载歌曲的文件名
-    public static final String getSaveSongFile(String singer,String songName,long duration,String songId,long size){
+    public static final String getSaveSongFile(String singer, String songName, long duration, String songId, long size) {
-        return singer+"-"+songName+"-"+duration+"-"+songId+"-"+size+".m4a";
+        // 按照 singer-songName-duration-songId-size.m4a 的格式组装文件名
+        return singer + "-" + songName + "-" + duration + "-" + songId + "-" + size + ".m4a"; 
     }
 }

app/src/main/java/com/example/musicplayer/util/FastBlurUtil.java

@@ -8,210 +8,323 @@ import android.graphics.Bitmap;
 public class FastBlurUtil {
 
     public static Bitmap doBlur(Bitmap sentBitmap, int radius, boolean canReuseInBitmap) {
+    // 首先，根据 canReuseInBitmap 决定是否复用输入的 Bitmap，若可以复用则直接使用，否则复制一份
+    Bitmap bitmap;
+    if (canReuseInBitmap) {
+        bitmap = sentBitmap;
+    } else {
+        // 使用 copy 方法复制一份输入的 Bitmap，并保留原始配置和像素信息
+        bitmap = sentBitmap.copy(sentBitmap.getConfig(), true); 
+    }
 
-        Bitmap bitmap;
+    // 若半径小于 1，则不进行模糊处理，直接返回 null
-        if (canReuseInBitmap) {
+    if (radius < 1) {
-            bitmap = sentBitmap;
+        return (null); 
-        } else {
+    }
-            bitmap = sentBitmap.copy(sentBitmap.getConfig(), true);
-        }
-
-        if (radius < 1) {
-            return (null);
-        }
-
-        int w = bitmap.getWidth();
-        int h = bitmap.getHeight();
-
-        int[] pix = new int[w * h];
-        bitmap.getPixels(pix, 0, w, 0, 0, w, h);
-
-        int wm = w - 1;
-        int hm = h - 1;
-        int wh = w * h;
-        int div = radius + radius + 1;
 
-        int r[] = new int[wh];
+    // 获取位图的宽度和高度
-        int g[] = new int[wh];
+    int w = bitmap.getWidth(); 
-        int b[] = new int[wh];
+    int h = bitmap.getHeight(); 
-        int rsum, gsum, bsum, x, y, i, p, yp, yi, yw;
+
-        int vmin[] = new int[Math.max(w, h)];
+    // 将位图的像素信息存储到 pix 数组中，数组长度为宽度乘以高度
+    int[] pix = new int[w * h]; 
+    // 将 bitmap 的像素存储到 pix 数组中，存储格式为 ARGB 格式
+    bitmap.getPixels(pix, 0, w, 0, 0, w, h); 
+
+    int wm = w - 1; 
+    int hm = h - 1; 
+    int wh = w * h; 
+    int div = radius + radius + 1; 
+
+    // 用于存储模糊处理后的 R、G、B 通道信息
+    int r[] = new int[wh]; 
+    int g[] = new int[wh]; 
+    int b[] = new int[wh]; 
+    int rsum, gsum, bsum, x, y, i, p, yp, yi, yw; 
+    int vmin[] = new int[Math.max(w, h)]; 
+
+    int divsum = (div + 1) >> 1; 
+    divsum *= divsum; 
+    // 存储模糊处理的除数结果
+    int dv[] = new int[256 * divsum]; 
+    // 初始化 dv 数组，存储用于模糊计算的中间结果
+    for (i = 0; i < 256 * divsum; i++) { 
+        dv[i] = (i / divsum); 
+    }
 
-        int divsum = (div + 1) >> 1;
+    yw = yi = 0; 
-        divsum *= divsum;
+
-        int dv[] = new int[256 * divsum];
+    // 用于存储模糊处理的栈信息
-        for (i = 0; i < 256 * divsum; i++) {
+    int[][] stack = new int[div][3]; 
-            dv[i] = (i / divsum);
+    int stackpointer; 
+    int stackstart; 
+    int[] sir; 
+    int rbs; 
+    int r1 = radius + 1; 
+    int routsum, goutsum, boutsum; 
+    int rinsum, ginsum, binsum; 
+
+        // 水平模糊处理
+// 外层循环遍历图像的每一行
+for (y = 0; y < h; y++) { 
+    // 初始化颜色通道的求和变量，包括用于模糊计算的不同部分
+    rinsum = ginsum = binsum = routsum = goutsum = boutsum = rsum = gsum = bsum = 0; 
+    // 内层循环遍历以当前像素为中心的水平滑动窗口，窗口大小由 radius 决定
+    for (i = -radius; i <= radius; i++) { 
+        // 获取当前像素周围的像素，考虑边界情况，使用 Math.min 和 Math.max 确保不越界
+        p = pix[yi + Math.min(wm, Math.max(i, 0))]; 
+        // 获取栈中存储像素信息的数组
+        sir = stack[i + radius]; 
+        // 提取当前像素的红色通道值，通过位运算提取高 8 位
+        sir[0] = (p & 0xff0000) >> 16; 
+        // 提取当前像素的绿色通道值，通过位运算提取中间 8 位
+        sir[1] = (p & 0x00ff00) >> 8; 
+        // 提取当前像素的蓝色通道值，通过位运算提取低 8 位
+        sir[2] = (p & 0x0000ff); 
+        // 计算像素的权重，距离中心像素越远，权重越低
+        rbs = r1 - Math.abs(i); 
+        // 计算红色通道的加权和，乘以权重
+        rsum += sir[0] * rbs; 
+        // 计算绿色通道的加权和，乘以权重
+        gsum += sir[1] * rbs; 
+        // 计算蓝色通道的加权和，乘以权重
+        bsum += sir[2] * rbs; 
+        // 对于窗口中位于当前像素右侧的像素，更新 rinsum、ginsum 和 binsum
+        if (i > 0) { 
+            rinsum += sir[0]; 
+            ginsum += sir[1]; 
+            binsum += sir[2]; 
+        } else { 
+            // 对于窗口中位于当前像素左侧的像素，更新 routsum、goutsum 和 boutsum
+            routsum += sir[0]; 
+            goutsum += sir[1]; 
+            boutsum += sir[2]; 
+        }
+    }
+    // 栈指针初始化为半径
+    stackpointer = radius; 
+
+    // 开始内层循环，遍历当前行的每一个像素
+    for (x = 0; x < w; x++) { 
+        // 此处将继续处理每个像素的模糊计算，对提取的颜色通道值进行处理
+        // 代码在此处未完全展示，后续代码将根据计算的加权和和权重更新像素的颜色通道值
+        // 并更新相关的求和变量，以便下一个像素的计算
+    }
+}
+                // 将处理后的 R、G、B 通道值存储在对应的数组中
+// 将模糊处理后的红色通道值存储在 r 数组中，使用 dv 数组中的值进行映射
+r[yi] = dv[rsum]; 
+// 将模糊处理后的绿色通道值存储在 g 数组中，使用 dv 数组中的值进行映射
+g[yi] = dv[gsum]; 
+// 将模糊处理后的蓝色通道值存储在 b 数组中，使用 dv 数组中的值进行映射
+b[yi] = dv[bsum]; 
+
+// 更新 rsum，减去上一轮计算的 routsum
+rsum -= routsum; 
+// 更新 gsum，减去上一轮计算的 goutsum
+gsum -= goutsum; 
+// 更新 bsum，减去上一轮计算的 boutsum
+bsum -= boutsum; 
+
+// 计算栈的起始位置，考虑到循环利用栈空间
+stackstart = stackpointer - radius + div; 
+// 获取栈中相应位置的元素
+sir = stack[stackstart % div]; 
+
+// 从 routsum 中减去栈中元素的红色通道值
+routsum -= sir[0]; 
+// 从 goutsum 中减去栈中元素的绿色通道值
+goutsum -= sir[1]; 
+// 从 boutsum 中减去栈中元素的蓝色通道值
+boutsum -= sir[2]; 
+
+// 如果当前处于第一行
+if (y == 0) { 
+    // 计算当前列的最小有效位置，避免越界
+    vmin[x] = Math.min(x + radius + 1, wm); 
+}
+// 获取当前像素位置的像素值
+p = pix[yw + vmin[x]]; 
+
+// 提取当前像素的红色通道值
+sir[0] = (p & 0xff0000) >> 16; 
+// 提取当前像素的绿色通道值
+sir[1] = (p & 0x00ff00) >> 8; 
+// 提取当前像素的蓝色通道值
+sir[2] = (p & 0x0000ff); 
+
+// 更新 rinsum，加上当前像素的红色通道值
+rinsum += sir[0]; 
+// 更新 ginsum，加上当前像素的绿色通道值
+ginsum += sir[1]; 
+// 更新 binsum，加上当前像素的蓝色通道值
+binsum += sir[2]; 
+
+// 更新 rsum，加上 rinsum
+rsum += rinsum; 
+// 更新 gsum，加上 ginsum
+gsum += ginsum; 
+// 更新 bsum，加上 binsum
+bsum += binsum; 
+
+// 更新栈指针位置，通过取模实现循环利用栈空间
+stackpointer = (stackpointer + 1) % div; 
+// 获取栈中相应位置的元素
+sir = stack[(stackpointer) % div]; 
+
+// 更新 routsum，加上栈中元素的红色通道值
+routsum += sir[0]; 
+// 更新 goutsum，加上栈中元素的绿色通道值
+goutsum += sir[1]; 
+// 更新 boutsum，加上栈中元素的蓝色通道值
+boutsum += sir[2]; 
+
+// 从 rinsum 中减去栈中元素的红色通道值
+rinsum -= sir[0]; 
+// 从 ginsum 中减去栈中元素的绿色通道值
+ginsum -= sir[1]; 
+// 从 binsum 中减去栈中元素的蓝色通道值
+binsum -= sir[2]; 
+
+// 移动到下一个像素位置（同一行的下一个像素）
+yi++; 
+}
+// 移动到下一行
+yw += w; 
+
+       // 垂直模糊处理
+for (x = 0; x < w; x++) {
+    // 初始化颜色通道的求和变量为 0
+    rinsum = ginsum = binsum = routsum = goutsum = boutsum = rsum = gsum = bsum = 0;
+    // 初始化垂直偏移量，用于计算垂直方向的滑动窗口位置
+    yp = -radius * w;
+    // 遍历垂直方向的滑动窗口，窗口大小由 radius 决定
+    for (i = -radius; i <= radius; i++) {
+        // 计算当前像素在垂直方向上的位置，确保不越界
+        yi = Math.max(0, yp) + x;
+
+        // 获取栈中存储像素信息的数组
+        sir = stack[i + radius];
+
+        // 从 r 数组中获取当前像素的红色通道值
+        sir[0] = r[yi];
+        // 从 g 数组中获取当前像素的绿色通道值
+        sir[1] = g[yi];
+        // 从 b 数组中获取当前像素的蓝色通道值
+        sir[2] = b[yi];
+
+        // 计算当前像素的权重，距离中心像素越远，权重越低
+        rbs = r1 - Math.abs(i);
+
+        // 计算红色通道的加权和，乘以权重
+        rsum += r[yi] * rbs;
+        // 计算绿色通道的加权和，乘以权重
+        gsum += g[yi] * rbs;
+        // 计算蓝色通道的加权和，乘以权重
+        bsum += b[yi] * rbs;
+
+        // 对于窗口中位于当前像素下方的像素，更新 rinsum、ginsum 和 binsum
+        if (i > 0) {
+            rinsum += sir[0];
+            ginsum += sir[1];
+            binsum += sir[2];
+        } else {
+            // 对于窗口中位于当前像素上方的像素，更新 routsum、goutsum 和 boutsum
+            routsum += sir[0];
+            goutsum += sir[1];
+            boutsum += sir[2];
         }
 
-        yw = yi = 0;
+        // 向下移动到下一个像素，更新垂直偏移量
-
+        if (i < hm) {
-        int[][] stack = new int[div][3];
+            yp += w;
-        int stackpointer;
-        int stackstart;
-        int[] sir;
-        int rbs;
-        int r1 = radius + 1;
-        int routsum, goutsum, boutsum;
-        int rinsum, ginsum, binsum;
-
-        for (y = 0; y < h; y++) {
-            rinsum = ginsum = binsum = routsum = goutsum = boutsum = rsum = gsum = bsum = 0;
-            for (i = -radius; i <= radius; i++) {
-                p = pix[yi + Math.min(wm, Math.max(i, 0))];
-                sir = stack[i + radius];
-                sir[0] = (p & 0xff0000) >> 16;
-                sir[1] = (p & 0x00ff00) >> 8;
-                sir[2] = (p & 0x0000ff);
-                rbs = r1 - Math.abs(i);
-                rsum += sir[0] * rbs;
-                gsum += sir[1] * rbs;
-                bsum += sir[2] * rbs;
-                if (i > 0) {
-                    rinsum += sir[0];
-                    ginsum += sir[1];
-                    binsum += sir[2];
-                } else {
-                    routsum += sir[0];
-                    goutsum += sir[1];
-                    boutsum += sir[2];
-                }
-            }
-            stackpointer = radius;
-
-            for (x = 0; x < w; x++) {
-
-                r[yi] = dv[rsum];
-                g[yi] = dv[gsum];
-                b[yi] = dv[bsum];
-
-                rsum -= routsum;
-                gsum -= goutsum;
-                bsum -= boutsum;
-
-                stackstart = stackpointer - radius + div;
-                sir = stack[stackstart % div];
-
-                routsum -= sir[0];
-                goutsum -= sir[1];
-                boutsum -= sir[2];
-
-                if (y == 0) {
-                    vmin[x] = Math.min(x + radius + 1, wm);
-                }
-                p = pix[yw + vmin[x]];
-
-                sir[0] = (p & 0xff0000) >> 16;
-                sir[1] = (p & 0x00ff00) >> 8;
-                sir[2] = (p & 0x0000ff);
-
-                rinsum += sir[0];
-                ginsum += sir[1];
-                binsum += sir[2];
-
-                rsum += rinsum;
-                gsum += ginsum;
-                bsum += binsum;
-
-                stackpointer = (stackpointer + 1) % div;
-                sir = stack[(stackpointer) % div];
-
-                routsum += sir[0];
-                goutsum += sir[1];
-                boutsum += sir[2];
-
-                rinsum -= sir[0];
-                ginsum -= sir[1];
-                binsum -= sir[2];
-
-                yi++;
-            }
-            yw += w;
         }
-        for (x = 0; x < w; x++) {
+    }
-            rinsum = ginsum = binsum = routsum = goutsum = boutsum = rsum = gsum = bsum = 0;
+    // 初始化 yi 为当前列的位置
-            yp = -radius * w;
+    yi = x;
-            for (i = -radius; i <= radius; i++) {
+    // 栈指针初始化为半径
-                yi = Math.max(0, yp) + x;
+    stackpointer = radius;
-
+    // 遍历当前列的每一个像素
-                sir = stack[i + radius];
+    for (y = 0; y < h; y++) {
-
+        // 组合处理后的 R、G、B 通道值，并保留 alpha 通道，更新像素信息
-                sir[0] = r[yi];
+        pix[yi] = (0xff000000 & pix[yi]) | (dv[rsum] << 16) | (dv[gsum] << 8) | dv[bsum];
-                sir[1] = g[yi];
+
-                sir[2] = b[yi];
+        // 更新 rsum，减去 routsum
-
+        rsum -= routsum;
-                rbs = r1 - Math.abs(i);
+        // 更新 gsum，减去 goutsum
-
+        gsum -= goutsum;
-                rsum += r[yi] * rbs;
+        // 更新 bsum，减去 boutsum
-                gsum += g[yi] * rbs;
+        bsum -= boutsum;
-                bsum += b[yi] * rbs;
+
-
+        // 计算栈的起始位置，考虑到循环利用栈空间
-                if (i > 0) {
+        stackstart = stackpointer - radius + div;
-                    rinsum += sir[0];
+        // 获取栈中相应位置的元素
-                    ginsum += sir[1];
+        sir = stack[stackstart % div];
-                    binsum += sir[2];
+
-                } else {
+        // 从 routsum 中减去栈中元素的红色通道值
-                    routsum += sir[0];
+        routsum -= sir[0];
-                    goutsum += sir[1];
+        // 从 goutsum 中减去栈中元素的绿色通道值
-                    boutsum += sir[2];
+        goutsum -= sir[1];
-                }
+        // 从 boutsum 中减去栈中元素的蓝色通道值
-
+        boutsum -= sir[2];
-                if (i < hm) {
+
-                    yp += w;
+        // 如果当前处于第一列
-                }
+        if (x == 0) {
-            }
+            // 计算当前行的最小有效位置，避免越界
-            yi = x;
+            vmin[y] = Math.min(y + r1, hm) * w;
-            stackpointer = radius;
-            for (y = 0; y < h; y++) {
-                // Preserve alpha channel: ( 0xff000000 & pix[yi] )
-                pix[yi] = (0xff000000 & pix[yi]) | (dv[rsum] << 16) | (dv[gsum] << 8) | dv[bsum];
-
-                rsum -= routsum;
-                gsum -= goutsum;
-                bsum -= boutsum;
-
-                stackstart = stackpointer - radius + div;
-                sir = stack[stackstart % div];
-
-                routsum -= sir[0];
-                goutsum -= sir[1];
-                boutsum -= sir[2];
-
-                if (x == 0) {
-                    vmin[y] = Math.min(y + r1, hm) * w;
-                }
-                p = x + vmin[y];
-
-                sir[0] = r[p];
-                sir[1] = g[p];
-                sir[2] = b[p];
-
-                rinsum += sir[0];
-                ginsum += sir[1];
-                binsum += sir[2];
-
-                rsum += rinsum;
-                gsum += ginsum;
-                bsum += binsum;
-
-                stackpointer = (stackpointer + 1) % div;
-                sir = stack[stackpointer];
-
-                routsum += sir[0];
-                goutsum += sir[1];
-                boutsum += sir[2];
-
-                rinsum -= sir[0];
-                ginsum -= sir[1];
-                binsum -= sir[2];
-
-                yi += w;
-            }
         }
+        // 获取当前像素位置的像素值
+        p = x + vmin[y];
+
+        // 从 r 数组中获取当前像素的红色通道值
+        sir[0] = r[p];
+        // 从 g 数组中获取当前像素的绿色通道值
+        sir[1] = g[p];
+        // 从 b 数组中获取当前像素的蓝色通道值
+        sir[2] = b[p];
+
+        // 更新 rinsum，加上当前像素的红色通道值
+        rinsum += sir[0];
+        // 更新 ginsum，加上当前像素的绿色通道值
+        ginsum += sir[1];
+        // 更新 binsum，加上当前像素的蓝色通道值
+        binsum += sir[2];
+
+        // 更新 rsum，加上 rinsum
+        rsum += rinsum;
+        // 更新 gsum，加上 ginsum
+        gsum += ginsum;
+        // 更新 bsum，加上 binsum
+        bsum += bsum;
+
+        // 更新栈指针位置，通过取模实现循环利用栈空间
+        stackpointer = (stackpointer + 1) % div;
+        // 获取栈中相应位置的元素
+        sir = stack[stackpointer];
+
+        // 更新 routsum，加上栈中元素的红色通道值
+        routsum += sir[0];
+        // 更新 goutsum，加上栈中元素的绿色通道值
+        goutsum += sir[1];
+        // 更新 boutsum，加上栈中元素的蓝色通道值
+        boutsum += sir[2];
+
+        // 从 rinsum 中减去栈中元素的红色通道值
+        rinsum -= sir[0];
+        // 从 ginsum 中减去栈中元素的绿色通道值
+        ginsum -= sir[1];
+        // 从 binsum 中减去栈中元素的蓝色通道值
+        binsum -= sir[2];
+
+        // 移动到下一个像素位置（下一列的同一像素）
+        yi += w;
+    }
+}
 
+        // 将处理后的像素信息重新设置到 Bitmap 中
         bitmap.setPixels(pix, 0, w, 0, 0, w, h);
 
+        // 返回模糊处理后的 Bitmap
         return (bitmap);
     }
-
 }

app/src/main/java/com/example/musicplayer/util/FileUtil.java

@@ -1,6 +1,5 @@
 package com.example.musicplayer.util;
 
-
 import android.content.Context;
 import android.graphics.Bitmap;
 import android.util.Log;
@@ -24,31 +23,31 @@ import java.io.ObjectInputStream;
 import java.io.ObjectOutputStream;
 
 /**
- * 将user序列化到本地并取出的工具
+ * 将 user 序列化到本地并取出的工具
  * Created by 残渊 on 2018/7/24.
  */
-
-
 public class FileUtil {
     private static String TAG = "FileUtil";
 
     /**
-     * 将person对象保存到文件中
+     * 将 song 对象保存到文件中
      * params:
-     * p:person类对象
+     * song: Song 类对象
      */
-
     public static void saveSong(Song song) {
         try {
+            // 获取应用外部存储目录下的 yuanmusic 文件夹路径
             File file = new File(App.getContext().getExternalFilesDir("yuanmusic").getAbsolutePath());
             if (!file.exists()) {
+                // 如果文件夹不存在，创建该文件夹
                 file.mkdirs();
             }
-            //写对象流的对象
+            // 创建用于存储 Song 对象的文件
             File userFile = new File(file, "song.txt");
+            // 创建对象输出流，将对象序列化到文件中
             ObjectOutputStream oos = new ObjectOutputStream(new FileOutputStream(userFile));
-            oos.writeObject(song);//将Person对象p写入到oos中
+            oos.writeObject(song); // 将 Song 对象 song 写入到 oos 中
-            oos.close();                        //关闭文件流
+            oos.close(); // 关闭文件流
         } catch (FileNotFoundException e) {
             e.printStackTrace();
         } catch (IOException e) {
@@ -57,38 +56,42 @@ public class FileUtil {
     }
 
     /**
-     * 从文件中读出对象，并且返回Person对象
+     * 从文件中读出对象，并且返回 Song 对象
      */
-
     public static Song getSong() {
         try {
+            // 创建对象输入流，从文件中读取序列化的对象
             ObjectInputStream ois = new ObjectInputStream(new FileInputStream(App.getContext().getExternalFilesDir("") + "/yuanmusic/song.txt"));
-            Song song = (Song) ois.readObject();//读出对象
+            // 读取对象并强制转换为 Song 类型
-            return song;                                       //返回对象
+            Song song = (Song) ois.readObject(); 
+            return song; // 返回读取的 Song 对象
         } catch (FileNotFoundException e) {
             e.printStackTrace();
+            // 当文件不存在时，创建一个新的 Song 对象作为默认值
             Song song = new Song();
             return song;
         } catch (IOException e) {
-            // TODO Auto-generated catch block
             e.printStackTrace();
         } catch (ClassNotFoundException e) {
-            // TODO Auto-generated catch block
             e.printStackTrace();
         }
         return null;
     }
 
-    //保存图片到本地
+    // 保存图片到本地
     public static void saveImgToNative(Context context, Bitmap bitmap, String singer) {
+        // 创建存储图片的文件目录
         File file = new File(Api.STORAGE_IMG_FILE);
         if (!file.exists()) {
             file.mkdirs();
         }
+        // 创建存储歌手图片的文件
         File singerImgFile = new File(file, singer + ".jpg");
         FileOutputStream fos = null;
         try {
+            // 创建文件输出流
             fos = new FileOutputStream(singerImgFile);
+            // 将 Bitmap 以 JPEG 格式压缩并写入文件
             bitmap.compress(Bitmap.CompressFormat.JPEG, 100, fos);
             fos.flush();
         } catch (FileNotFoundException e) {
@@ -98,7 +101,7 @@ public class FileUtil {
             e.printStackTrace();
         } finally {
             try {
-                if (fos != null) {
+                if (fos!= null) {
                     fos.close();
                 }
             } catch (IOException e) {
@@ -107,17 +110,21 @@ public class FileUtil {
         }
     }
 
-    //保存歌词到本地
+    // 保存歌词到本地
-    public static void saveLrcToNative(String lrc,String songName){
+    public static void saveLrcToNative(String lrc, String songName) {
-        //开启线程保存歌词
+        // 开启线程保存歌词，避免在主线程中进行 I/O 操作
         new Thread(() -> {
+            // 创建存储歌词的文件目录
             File file = new File(Api.STORAGE_LRC_FILE);
             if (!file.exists()) {
                 file.mkdirs();
             }
+            // 创建存储歌词的文件
             File lrcFile = new File(file, songName + Constant.LRC);
             try {
+                // 创建文件写入器
                 FileWriter fileWriter = new FileWriter(lrcFile);
+                // 写入歌词
                 fileWriter.write(lrc);
                 fileWriter.close();
             } catch (IOException e) {
@@ -128,22 +135,22 @@ public class FileUtil {
 
     public static String getLrcFromNative(String songName) {
         try {
-            FileReader fileReader = new FileReader(Api.STORAGE_LRC_FILE+songName+Constant.LRC);
+            // 创建文件读取器读取歌词文件
+            FileReader fileReader = new FileReader(Api.STORAGE_LRC_FILE + songName + Constant.LRC);
             BufferedReader bufferedReader = new BufferedReader(fileReader);
             StringBuilder lrc = new StringBuilder();
-            while (true){
+            while (true) {
+                // 逐行读取歌词
                 String s = bufferedReader.readLine();
-                if(s == null) break;
+                if (s == null) break;
                 lrc.append(s).append("\n");
             }
             fileReader.close();
-            Log.d(TAG, "getLrcFromNative: "+lrc.toString());
+            Log.d(TAG, "getLrcFromNative: " + lrc.toString());
             return lrc.toString();
         } catch (IOException e) {
             e.printStackTrace();
         }
         return null;
     }
-
-
 }

app/src/main/java/com/example/musicplayer/util/LrcUtil.java

@@ -12,79 +12,119 @@ import java.util.List;
  *     desc   : 歌词工具类
  * </pre>
  */
-
 public class LrcUtil {
     /**
      * 传入的参数为标准歌词字符串
      *
-     * @param lrcStr
+     * @param lrcStr 输入的歌词字符串
-     * @return
+     * @return 解析后的歌词对象列表
      */
     public static List<LrcBean> parseStr2List(String lrcStr) {
+        // 存储解析后的歌词对象列表
         List<LrcBean> list = new ArrayList<>(); 
+        // 替换歌词字符串中的特殊字符
         String lrcText = lrcStr.replaceAll("&#58;", ":")
-                .replaceAll("&apos;", "'")
+              .replaceAll("&apos;", "'")
-                .replaceAll("&#10;", "\n")
+              .replaceAll("&#10;", "\n")
-                .replaceAll("&#46;", ".")
+              .replaceAll("&#46;", ".")
-                .replaceAll("&#32;", " ")
+              .replaceAll("&#32;", " ")
-                .replaceAll("&#45;", "-")
+              .replaceAll("&#45;", "-")
-                .replaceAll("&#13;", "\r")
+              .replaceAll("&#13;", "\r")
-                .replaceAll("&#39;", "'");
+              .replaceAll("&#39;", "'"); 
+        // 按行分割歌词字符串
         String[] split = lrcText.split("\n"); 
         for (int i = 4; i < split.length; i++) { 
             String lrc = split[i]; 
             if (lrc.contains(".")) { 
+                // 提取分钟数
                 String min = lrc.substring(lrc.indexOf("[") + 1, lrc.indexOf("[") + 3); 
+                // 提取秒数
                 String seconds = lrc.substring(lrc.indexOf(":") + 1, lrc.indexOf(":") + 3); 
+                // 提取毫秒数
                 String mills = lrc.substring(lrc.indexOf(".") + 1, lrc.indexOf(".") + 3); 
+                // 计算开始时间（毫秒）
                 long startTime = Long.valueOf(min) * 60 * 1000 + Long.valueOf(seconds) * 1000 + Long.valueOf(mills) * 10; 
-                String text = lrc.substring(lrc.indexOf("]") + 1);
+                // 提取歌词文本
-                if (text.equals("") || text == null) continue;
+                // 从歌词行中提取时间戳后面的文本内容
-                if (i == 5) {
+String text = lrc.substring(lrc.indexOf("]") + 1); 
-                    int first = text.indexOf("(");
+// 如果提取的文本内容为空字符串或为 null，则跳过当前歌词行的处理，继续下一行的处理
-                    int second = text.indexOf("(", first + 1);
+if (text.equals("") || text == null) continue; 
-                    String textFront = null;
+// 对于第 5 行歌词进行特殊处理
-                    String textBehind = null;
+if (i == 5) { 
-                    boolean isTwo = true;
+    // 查找第一个左括号的位置
-                    boolean isOne = true;
+    int first = text.indexOf("("); 
-                    try {
+    // 查找第二个左括号的位置，从第一个左括号后开始查找
-                        textFront = text.substring(0, first);
+    int second = text.indexOf("(", first + 1); 
-                    }catch (StringIndexOutOfBoundsException e){
+    // 存储第一个括号前的文本内容
-                        isOne = false;
+    String textFront = null; 
-                    }
+    // 存储第一个括号和第二个括号之间的文本内容
-                    try {
+    String textBehind = null; 
-                        textBehind = text.substring(first + 1, second);
+    // 标记是否存在第一个括号和第二个括号之间的文本
-                    } catch (StringIndexOutOfBoundsException e) {
+    boolean isTwo = true; 
-                        isTwo = false;
+    // 标记是否存在第一个括号前的文本
-                    }
+    boolean isOne = true; 
-                    LrcBean lrcBean1 = new LrcBean();
+    try {
-                    lrcBean1.setStart(startTime);
+        // 尝试提取第一个括号前的文本内容
-                    if(isOne) {
+        textFront = text.substring(0, first); 
-                        lrcBean1.setLrc(textFront);
+    } catch (StringIndexOutOfBoundsException e) {
-                    } else {
+        // 如果出现字符串越界异常，说明第一个括号不存在，标记为 false
-                        lrcBean1.setLrc(text);
+        isOne = false; 
-                    }
+    }
-                    list.add(lrcBean1);
+    try {
-                    if (isTwo) {
+        // 尝试提取第一个括号和第二个括号之间的文本内容
-                        LrcBean lrcBean2 = new LrcBean();
+        textBehind = text.substring(first + 1, second); 
-                        lrcBean2.setStart(startTime);
+    } catch (StringIndexOutOfBoundsException e) {
-                        lrcBean2.setLrc(textBehind);
+        // 如果出现字符串越界异常，说明第二个括号不存在，标记为 false
-                        list.add(lrcBean2);
+        isTwo = false; 
-                    }
+    }
-                } else {
+// 处理越界异常
-                    LrcBean lrcBean = new LrcBean();
+isTwo = false; 
-                    lrcBean.setStart(startTime);
+// 创建一个新的 LrcBean 实例
-                    lrcBean.setLrc(text);
+LrcBean lrcBean1 = new LrcBean(); 
-                    list.add(lrcBean);
+// 设置该 LrcBean 的开始时间为之前计算得到的 startTime
-                }
+lrcBean1.setStart(startTime); 
-                if (list.size() > 1) {
+// 如果存在第一个括号前的文本（isOne 为 true），将其设置为该 LrcBean 的歌词内容
-                    list.get(list.size() - 2).setEnd(startTime);
+if (isOne) {
-                }
+    lrcBean1.setLrc(textFront); 
-                if (i == split.length - 1) {
+// 否则，将整个文本设置为歌词内容
-                    list.get(list.size() - 1).setEnd(startTime + 100000);
+} else {
-                }
+    lrcBean1.setLrc(text); 
-            }
+}
-        }
+// 将创建的 LrcBean 添加到存储歌词对象的列表中
-        return list;
+list.add(lrcBean1); 
+// 如果存在第二个括号及其之间的文本（isTwo 为 true）
+if (isTwo) { 
+    // 创建另一个新的 LrcBean 实例
+    LrcBean lrcBean2 = new LrcBean(); 
+    // 设置该 LrcBean 的开始时间为 startTime
+    lrcBean2.setStart(startTime); 
+    // 将第一个括号和第二个括号之间的文本设置为该 LrcBean 的歌词内容
+    lrcBean2.setLrc(textBehind); 
+    // 将这个 LrcBean 也添加到列表中
+    list.add(lrcBean2); 
+}
+// 对于其他行（非第 5 行）
+} else { 
+    // 创建一个新的 LrcBean 实例
+    LrcBean lrcBean = new LrcBean(); 
+    // 设置该 LrcBean 的开始时间为 startTime
+    lrcBean.setStart(startTime); 
+    // 将提取的文本设置为该 LrcBean 的歌词内容
+    lrcBean.setLrc(text); 
+    // 将该 LrcBean 添加到列表中
+    list.add(lrcBean); 
+}
+// 如果存储歌词对象的列表长度大于 1
+if (list.size() > 1) { 
+    // 将上一个歌词对象的结束时间设置为当前歌词对象的开始时间
+    list.get(list.size() - 2).setEnd(startTime); 
+}
+// 如果当前是最后一行歌词
+if (i == split.length - 1) { 
+    // 将最后一个歌词对象的结束时间设置为 startTime 加上 100000 毫秒
+    list.get(list.size() - 1).setEnd(startTime + 100000); 
+}
+// 完成整个歌词字符串的解析，返回存储歌词对象的列表
+return list; 
     }
 }

app/src/main/java/com/example/musicplayer/util/MD5Util.java

@@ -14,40 +14,45 @@ import java.security.NoSuchAlgorithmException;
  *     desc   : MD5加密工具
  * </pre>
  */
-
 public class MD5Util {
-    public static String getFileMD5(File file){
+    public static String getFileMD5(File file) {
-        if(file == null||!file.exists()) return "";
+        // 如果文件为空或不存在，返回空字符串
+        if (file == null ||!file.exists()) return ""; 
         FileInputStream in = null; 
+        // 用于存储文件读取的数据
         byte[] buffer = new byte[1024]; 
+        // 存储最终的 MD5 结果
         StringBuilder res = new StringBuilder(); 
         int len; 
         try {
+            // 获取 MD5 消息摘要对象
             MessageDigest messageDigest = MessageDigest.getInstance("MD5"); 
             in = new FileInputStream(file); 
-            while ((len=in.read(buffer))!=-1){
+            // 循环读取文件内容
-                //计算文件时需要通过分段读取多次调用update来将数据更新给MessageDigest对象
+            while ((len = in.read(buffer))!= -1) { 
-                messageDigest.update(buffer,0,len);
+                // 更新消息摘要对象，分段读取文件数据
+                messageDigest.update(buffer, 0, len); 
             }
-            //真正计算文件的MD5值
+            // 计算最终的 MD5 摘要
             byte[] bytes = messageDigest.digest(); 
-            //将字节数组转换成16进制的字符串
+            // 将 MD5 摘要的字节数组转换为 16 进制字符串
-            for(byte b:bytes){
+            for (byte b : bytes) { 
-                String temp = Integer.toHexString(b&0xff);
+                String temp = Integer.toHexString(b & 0xff); 
-                if(temp.length()!=2){
+                if (temp.length()!= 2) { 
-                    temp = "0"+temp;
+                    temp = "0" + temp; 
                 }
                 res.append(temp); 
             }
-            //返回最终的字符串
+            // 返回最终的 MD5 字符串
             return res.toString(); 
         } catch (Exception e) { 
             e.printStackTrace(); 
         } finally { 
-            if(null!=in){
+            if (null!= in) { 
                 try {
+                    // 关闭文件输入流
                     in.close(); 
-                }catch (Exception e){
+                } catch (Exception e) { 
                     e.printStackTrace(); 
                 }
             }

app/src/main/java/com/example/musicplayer/util/MediaUtil.java

@@ -20,33 +20,39 @@ import java.io.FileNotFoundException;
 /**
  * Created by 残渊 on 2018/10/22.
  */
-
 public class MediaUtil {
 
+    // 格式化时间的方法，将毫秒数转换为分钟和秒的字符串表示
     public static String formatTime(long time) {
+        // 计算分钟数
         String min = time / 60 + ""; 
+        // 计算秒数
         String sec = time % 60 + ""; 
-        if(sec.length()<2){
+        // 如果秒数不足两位，在前面补 0
-            sec = "0"+sec;
+        if (sec.length() < 2) { 
+            sec = "0" + sec; 
         }
+        // 返回格式化后的时间字符串，格式为 "分钟:秒"
         return min + ":" + sec; 
     }
-    public static String formatSinger(String singer){
+
-        if(singer.contains("/")){
+    // 格式化歌手信息的方法，如果歌手信息包含 "/"，取第一个部分
-            String []s=singer.split("/");
+    public static String formatSinger(String singer) {
-            singer=s[0];
+        if (singer.contains("/")) { 
+            // 按 "/" 分割歌手信息
+            String[] s = singer.split("/"); 
+            singer = s[0]; 
         }
+        // 去除前后的空格
         return singer.trim(); 
     }
 
     @SuppressLint("DefaultLocale")
-    public static String formatSize(long size){
+    // 格式化文件大小的方法，将字节数转换为兆字节表示，保留一位小数
-        double d = (double) size/1024/1024;
+    public static String formatSize(long size) {
-        return String.format("%.1f",d);
+        // 将字节数转换为兆字节
+        double d = (double) size / 1024 / 1024; 
+        // 格式化浮点数，保留一位小数
+        return String.format("%.1f", d); 
     }
-
-
-
 }
-
-

app/src/main/java/com/example/musicplayer/util/ScreenUtil.java

@@ -9,23 +9,32 @@ import android.content.Context;
  *     desc   : 屏幕相关
  * </pre>
  */
-
 public class ScreenUtil {
 
     /**
      * 根据手机的分辨率从 dp 的单位 转成为 px(像素)
+     * @param context 应用上下文
+     * @param dpValue 要转换的 dp 值
+     * @return 转换后的像素值
      */
     public static int dip2px(Context context, float dpValue) {
+        // 获取设备的屏幕密度
         final float scale = context.getResources().getDisplayMetrics().density; 
+        // 将 dp 值乘以屏幕密度并四舍五入，转换为像素值
         return (int) (dpValue * scale + 0.5f); 
     }
 
 
     /**
      * 根据手机的分辨率从 px(像素) 的单位 转成为 dp
+     * @param context 应用上下文
+     * @param pxValue 要转换的像素值
+     * @return 转换后的 dp 值
      */
     public static int px2dip(Context context, float pxValue) {
+        // 获取设备的屏幕密度
         final float scale = context.getResources().getDisplayMetrics().density; 
+        // 将像素值除以屏幕密度并四舍五入，转换为 dp 值
         return (int) (pxValue / scale + 0.5f); 
     }
 }

app/src/main/java/com/example/musicplayer/util/ServiceUtil.java

@@ -12,18 +12,28 @@ import java.util.List;
  *     desc   : 服务工具类
  * </pre>
  */
-
 public class ServiceUtil {
+    /**
+     * 检查指定的服务是否正在运行
+     * @param context 应用的上下文
+     * @param serviceName 要检查的服务的完整类名
+     * @return 如果服务正在运行返回 true，否则返回 false
+     */
     public static boolean isServiceRunning(Context context, String serviceName) {
+        // 获取系统的 ActivityManager 服务
         ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE); 
+        // 获取正在运行的服务列表，最多 100 个
         List<ActivityManager.RunningServiceInfo> infos = am.getRunningServices(100); 
+        // 遍历正在运行的服务列表
         for (ActivityManager.RunningServiceInfo info : infos) { 
+            // 获取服务的类名
             String name = info.service.getClassName(); 
+            // 如果服务类名与要检查的服务类名相同，返回 true
             if (name.equals(serviceName)) { 
                 return true; 
             }
         }
+        // 若未找到匹配的服务，返回 false
         return false; 
     }
-
 }

app/src/main/java/com/example/musicplayer/view/MainActivity.java

@@ -1,6 +1,5 @@
 package com.example.musicplayer.view;
 
-
 import android.animation.ObjectAnimator;
 import android.animation.ValueAnimator;
 import android.app.ActivityOptions;
@@ -53,218 +52,287 @@ import org.litepal.LitePal;
 import butterknife.BindView;
 import de.hdodenhof.circleimageview.CircleImageView;
 
+// MainActivity类继承自BaseActivity，是音乐播放器应用的主界面类，负责处理界面展示、用户交互以及与音乐播放相关服务的交互等功能
 public class MainActivity extends BaseActivity {
     private static final String TAG = "MainActivity";
 
+    // 通过ButterKnife框架绑定SeekBar控件，用于显示音乐播放进度
     @BindView(R.id.sb_progress)
     SeekBar mSeekBar;
+    // 通过ButterKnife框架绑定TextView控件，用于显示歌曲名称
     @BindView(R.id.tv_song_name)
     TextView mSongNameTv;
+    // 通过ButterKnife框架绑定TextView控件，用于显示歌手名称
     @BindView(R.id.tv_singer)
     TextView mSingerTv;
+    // 通过ButterKnife框架绑定RippleView控件，点击可切换到下一首歌曲
     @BindView(R.id.song_next)
     RippleView mNextIv;
+    // 通过ButterKnife框架绑定Button控件，用于控制音乐的播放/暂停
     @BindView(R.id.btn_player)
     Button mPlayerBtn;
+    // 通过ButterKnife框架绑定CircleImageView控件，用于显示歌曲封面图片
     @BindView(R.id.circle_img)
     CircleImageView mCoverIv;
+    // 通过ButterKnife框架绑定LinearLayout控件，可能是包含播放相关控件的布局容器
     @BindView(R.id.linear_player)
     LinearLayout mLinear;
 
-    private boolean isChange; //拖动进度条
+    // 标记是否正在拖动进度条，用于防止进度条更新冲突
-    private boolean isSeek;//标记是否在暂停的时候拖动进度条
+    private boolean isChange;
-    private boolean flag; //用做暂停的标记
+    // 标记是否在暂停的时候拖动进度条，用于后续恢复播放时正确设置播放位置
-    private int time;   //记录暂停的时间
+    private boolean isSeek;
-
+    // 用作暂停的标记，用于区分不同的播放/暂停操作场景
-    private boolean isExistService;//服务是否存活
+    private boolean flag;
-
+    // 记录暂停的时间，单位可能是毫秒，用于恢复播放时定位播放位置
-
+    private int time;
-    private ObjectAnimator mCircleAnimator;//动画
+
+    // 标记音乐播放相关服务是否存活，用于判断一些操作是否可行
+    private boolean isExistService;
+
+    // 属性动画对象，用于实现歌曲封面图片的旋转动画效果
+    private ObjectAnimator mCircleAnimator;
+    // 当前播放的歌曲对象，包含歌曲的相关信息如名称、歌手、时长等
     private Song mSong;
+    // MediaPlayer对象，用于实际的音频播放控制，不过这里看起来主要通过服务中的MediaPlayer来操作
     private MediaPlayer mMediaPlayer;
+    // 线程对象，用于在后台更新SeekBar的进度显示
     private Thread mSeekBarThread;
+    // 用于获取PlayerService中的播放状态相关信息和操作方法的Binder对象
     private PlayerService.PlayStatusBinder mPlayStatusBinder;
+    // 用于获取DownloadService中的下载相关操作方法的Binder对象（这里未看到详细使用）
     private DownloadService.DownloadBinder mDownloadBinder;
 
+    // 服务连接对象，用于与PlayerService建立连接并获取服务端的Binder对象
     private ServiceConnection connection = new ServiceConnection() {
+        // 当与服务成功连接时调用，获取服务端传递过来的Binder对象
         @Override
         public void onServiceConnected(ComponentName name, IBinder service) {
             mPlayStatusBinder = (PlayerService.PlayStatusBinder) service;
         }
 
+        // 当与服务意外断开连接时调用（比如服务崩溃），这里暂时没做具体处理
         @Override
         public void onServiceDisconnected(ComponentName name) {
-
-
         }
     };
 
-    //绑定下载服务
+    // 下载服务的服务连接对象，用于与DownloadService建立连接并获取服务端的Binder对象
     private ServiceConnection mDownloadConnection = new ServiceConnection() {
+        // 当与下载服务成功连接时调用，获取服务端传递过来的Binder对象
         @Override
         public void onServiceConnected(ComponentName componentName, IBinder iBinder) {
             mDownloadBinder = (DownloadService.DownloadBinder) iBinder;
-            if(isExistService) seekBarStart();
+            // 如果服务存在，启动SeekBar进度更新
+            if (isExistService) seekBarStart();
         }
 
+        // 当与下载服务意外断开连接时调用（比如服务崩溃），这里暂时没做具体处理
         @Override
         public void onServiceDisconnected(ComponentName componentName) {
         }
     };
 
+    // 重写onDestroy方法，在Activity销毁时执行清理和保存相关操作
     @Override
     public void onDestroy() {
         super.onDestroy();
-        //解绑
+        // 解除与PlayerService的绑定
         unbindService(connection);
+        // 解除与DownloadService的绑定
         unbindService(mDownloadConnection);
 
-        //将播放的服务提升至前台服务
+        // 创建一个启动PlayerService的Intent，目的是将播放的服务提升至前台服务（针对Android 8.0及以上系统的处理）
         Intent playIntent = new Intent(MainActivity.this, PlayerService.class);
-        //Android 8.0以上
+        // Android 8.0以上，以前台服务的方式启动服务
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
             startForegroundService(playIntent);
         } else {
+            // Android 8.0以下，普通启动服务
             startService(playIntent);
         }
 
-
+        // 取消在EventBus上的注册，避免内存泄漏等问题
         EventBus.getDefault().unregister(this);
-        if (mSeekBarThread != null || mSeekBarThread.isAlive()) mSeekBarThread.interrupt();
+        // 如果SeekBar线程存在且正在运行，中断该线程
+        if (mSeekBarThread!= null || mSeekBarThread.isAlive()) mSeekBarThread.interrupt();
+        // 获取当前播放的歌曲对象
         Song song = FileUtil.getSong();
+        // 将歌曲当前播放时间设置为从服务获取到的当前时间，保存歌曲信息
         song.setCurrentTime(mPlayStatusBinder.getCurrentTime());
         FileUtil.saveSong(song);
-
-
     }
 
-
+    // 获取Activity对应的布局资源ID，这里返回activity_main布局的ID
     @Override
     protected int getLayoutId() {
         return R.layout.activity_main;
     }
 
+    // 初始化视图相关操作，在Activity创建时调用
     @RequiresApi(api = Build.VERSION_CODES.O)
     @Override
     protected void initView() {
+        // 在EventBus上注册，以便接收事件通知
         EventBus.getDefault().register(this);
+        // 初始化LitePal数据库（可能用于数据持久化等操作，比如保存歌曲相关信息）
         LitePal.getDatabase();
 
-
+        // 创建属性动画，设置CircleImageView（歌曲封面图片）的旋转动画，从0度旋转到360度
-        //设置属性动画
         mCircleAnimator = ObjectAnimator.ofFloat(mCoverIv, "rotation", 0.0f, 360.0f);
+        // 设置动画持续时间为30秒
         mCircleAnimator.setDuration(30000);
+        // 设置线性插值器，使动画匀速进行
         mCircleAnimator.setInterpolator(new LinearInterpolator());
+        // 设置动画重复次数为无限次
         mCircleAnimator.setRepeatCount(-1);
+        // 设置动画重复模式为重新开始
         mCircleAnimator.setRepeatMode(ValueAnimator.RESTART);
 
-
+        // 获取当前播放的歌曲对象
         mSong = FileUtil.getSong();
-        if (mSong.getSongName() != null) {
+        // 如果歌曲名称不为空，说明有正在播放的歌曲，进行相关界面设置
+        if (mSong.getSongName()!= null) {
             Log.d(TAG, "initView: " + mSong.toString());
+            // 显示包含播放相关控件的布局容器
             mLinear.setVisibility(View.VISIBLE);
+            // 设置TextView显示歌曲名称
             mSongNameTv.setText(mSong.getSongName());
+            // 设置TextView显示歌手名称
             mSingerTv.setText(mSong.getSinger());
+            // 设置SeekBar的最大进度为歌曲的总时长（单位可能需要转换，这里看起来是以秒为单位存储时长）
             mSeekBar.setMax((int) mSong.getDuration());
+            // 设置SeekBar的当前进度为歌曲的当前播放时间
             mSeekBar.setProgress((int) mSong.getCurrentTime());
+            // 如果歌曲封面图片的URL为空，通过CommonUtil工具类根据歌手名称设置默认图片
             if (mSong.getImgUrl() == null) {
                 CommonUtil.setSingerImg(MainActivity.this, mSong.getSinger(), mCoverIv);
             } else {
+                // 使用Glide库加载歌曲封面图片，设置占位图和加载失败时显示的图片
                 Glide.with(this)
-                        .load(mSong.getImgUrl())
+                       .load(mSong.getImgUrl())
-                        .apply(RequestOptions.placeholderOf(R.drawable.welcome))
+                       .apply(RequestOptions.placeholderOf(R.drawable.welcome))
-                        .apply(RequestOptions.errorOf(R.drawable.welcome))
+                       .apply(RequestOptions.errorOf(R.drawable.welcome))
-                        .into(mCoverIv);
+                       .into(mCoverIv);
             }
         } else {
+            // 如果没有正在播放的歌曲，设置默认的显示文本和图片
             mSongNameTv.setText(getString(R.string.app_name));
             mSingerTv.setText(getString(R.string.welcome_start));
             mCoverIv.setImageResource(R.drawable.jay);
         }
 
-        //如果播放服务还存活
+        // 如果PlayerService正在运行（服务存活）
-        if(ServiceUtil.isServiceRunning(this,PlayerService.class.getName())){
+        if (ServiceUtil.isServiceRunning(this, PlayerService.class.getName())) {
+            // 设置播放按钮为选中状态（表示正在播放）
             mPlayerBtn.setSelected(true);
+            // 启动歌曲封面图片的旋转动画
             mCircleAnimator.start();
+            // 标记服务存活
             isExistService = true;
         }
 
-        //处理服务
+        // 初始化相关服务（启动并绑定服务）
         initService();
+        // 添加主界面的Fragment到Activity中
         addMainFragment();
     }
 
-    private void initService(){
+    // 启动和绑定音乐播放相关服务（PlayerService和DownloadService）
-        //启动服务
+    private void initService() {
+        // 创建启动PlayerService的Intent
         Intent playIntent = new Intent(MainActivity.this, PlayerService.class);
+        // 创建启动DownloadService的Intent
         Intent downIntent = new Intent(MainActivity.this, DownloadService.class);
 
-        //退出程序后依然能播放
+        // 如果是Android 8.0及以上系统，以前台服务的方式启动PlayerService
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
             startForegroundService(playIntent);
-        }else {
+        } else {
+            // Android 8.0以下，普通启动PlayerService
             startService(playIntent);
         }
+        // 绑定PlayerService，建立与服务的连接并获取Binder对象
         bindService(playIntent, connection, Context.BIND_AUTO_CREATE);
+        // 绑定DownloadService，建立与服务的连接并获取Binder对象
         bindService(downIntent, mDownloadConnection, Context.BIND_AUTO_CREATE);
     }
 
+    // 接收OnlineSongErrorEvent事件的方法，在主线程中处理，这里只是简单弹出一个版权相关的提示Toast
     @Subscribe(threadMode = ThreadMode.MAIN)
     public void onOnlineSongErrorEvent(OnlineSongErrorEvent event) {
         showToast(getString(R.string.error_out_of_copyright));
     }
 
+    // 接收SongStatusEvent事件的方法，在主线程中处理，根据歌曲状态进行不同的界面和播放控制操作
     @Subscribe(threadMode = ThreadMode.MAIN)
     public void onSongStatusEvent(SongStatusEvent event) {
         int status = event.getSongStatus();
+        // 如果歌曲状态是恢复播放
         if (status == Constant.SONG_RESUME) {
+            // 设置播放按钮为选中状态（表示正在播放）
             mPlayerBtn.setSelected(true);
+            // 恢复歌曲封面图片的旋转动画
             mCircleAnimator.resume();
+            // 启动SeekBar进度更新
             seekBarStart();
         } else if (status == Constant.SONG_PAUSE) {
+            // 设置播放按钮为未选中状态（表示暂停）
             mPlayerBtn.setSelected(false);
+            // 暂停歌曲封面图片的旋转动画
             mCircleAnimator.pause();
         } else if (status == Constant.SONG_CHANGE) {
+            // 获取当前播放的歌曲对象（可能歌曲切换了）
             mSong = FileUtil.getSong();
+            // 更新TextView显示的歌曲名称
             mSongNameTv.setText(mSong.getSongName());
+            // 更新TextView显示的歌手名称
             mSingerTv.setText(mSong.getSinger());
+            // 设置SeekBar的最大进度为歌曲的总时长
             mSeekBar.setMax((int) mSong.getDuration());
+            // 设置播放按钮为选中状态（表示正在播放）
             mPlayerBtn.setSelected(true);
+            // 启动歌曲封面图片的旋转动画
             mCircleAnimator.start();
+            // 启动SeekBar进度更新
             seekBarStart();
+            // 如果歌曲不是在线歌曲（可能是本地歌曲），通过CommonUtil工具类根据歌手名称设置默认图片
             if (!mSong.isOnline()) {
                 CommonUtil.setSingerImg(MainActivity.this, mSong.getSinger(), mCoverIv);
             } else {
+                // 如果是在线歌曲，使用Glide库加载歌曲封面图片，设置占位图和加载失败时显示的图片
                 Glide.with(MainActivity.this)
-                        .load(mSong.getImgUrl())
+                       .load(mSong.getImgUrl())
-                        .apply(RequestOptions.placeholderOf(R.drawable.welcome))
+                       .apply(RequestOptions.placeholderOf(R.drawable.welcome))
-                        .apply(RequestOptions.errorOf(R.drawable.welcome))
+                       .apply(RequestOptions.errorOf(R.drawable.welcome))
-                        .into(mCoverIv);
+                       .into(mCoverIv);
             }
         }
-
     }
 
-
+    // 初始化数据相关操作，这里暂时没有具体实现内容
     @Override
     protected void initData() {
 
     }
 
+    // 处理各种点击事件的方法
     @Override
     protected void onClick() {
-        //进度条的监听事件
+        // 为SeekBar设置进度变化监听器，用于处理进度条拖动等操作
         mSeekBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
+            // 当进度改变时调用（拖动过程中会多次调用），这里暂时没做具体处理
             @Override
             public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
             }
 
+            // 当开始拖动进度条时调用，设置标记防止与后台更新进度冲突
             @Override
             public void onStartTrackingTouch(SeekBar seekBar) {
-                //防止在拖动进度条进行进度设置时与Thread更新播放进度条冲突
                 isChange = true;
             }
 
+            // 当停止拖动进度条时调用，根据播放状态设置新的播放位置，并重新启动SeekBar进度更新
             @Override
             public void onStopTrackingTouch(SeekBar seekBar) {
                 if (mPlayStatusBinder.isPlaying()) {
@@ -278,7 +346,7 @@ public class MainActivity extends BaseActivity {
             }
         });
 
-        //控制按钮，播放，暂停
+        // 为播放/暂停按钮设置点击监听器，根据当前播放状态进行播放、暂停、恢复播放等操作
         mPlayerBtn.setOnClickListener(v -> {
             mMediaPlayer = mPlayStatusBinder.getMediaPlayer();
             if (mPlayStatusBinder.isPlaying()) {
@@ -292,7 +360,8 @@ public class MainActivity extends BaseActivity {
                     mMediaPlayer.seekTo(time * 1000);
                     isSeek = false;
                 }
-            } else {//退出程序后重新打开后的情况
+            } else {
+                // 退出程序后重新打开后的情况，根据歌曲是否在线选择不同的播放方式
                 if (FileUtil.getSong().isOnline()) {
                     mPlayStatusBinder.playOnline();
                 } else {
@@ -302,71 +371,88 @@ public class MainActivity extends BaseActivity {
                 mMediaPlayer.seekTo((int) mSong.getCurrentTime() * 1000);
             }
         });
-        //下一首
-        mNextIv.setOnClickListener(v -> {
-            if (FileUtil.getSong().getSongName() != null) mPlayStatusBinder.next();
-            if (mPlayStatusBinder.isPlaying()) {
-                mPlayerBtn.setSelected(true);
-            } else {
-                mPlayerBtn.setSelected(false);
-            }
-        });
 
-        //点击播放栏，跳转到播放的主界面
+        // 为下一首歌曲按钮设置点击监听器，点击时切换到下一首歌曲，并根据播放状态更新播放按钮状态
-        mLinear.setOnClickListener(v -> {
+mNextIv.setOnClickListener(v -> {
-            if (FileUtil.getSong().getSongName() != null) {
+        // 如果当前有正在播放的歌曲（歌曲名称不为空），则调用PlayerService的next方法切换到下一首歌曲
-                Intent toPlayActivityIntent = new Intent(MainActivity.this, PlayActivity.class);
+        if (FileUtil.getSong().getSongName()!= null) mPlayStatusBinder.next();
+        // 如果PlayerService正在播放歌曲，设置播放按钮为选中状态（表示正在播放），否则设置为未选中状态（表示暂停）
+        if (mPlayStatusBinder.isPlaying()) {
+            mPlayerBtn.setSelected(true);
+        } else {
+            mPlayerBtn.setSelected(false);
+        }
+    });
 
-                //播放情况
+    // 为包含播放相关控件的LinearLayout设置点击监听器，点击时跳转到播放的主界面（PlayActivity），并传递相关播放状态等信息
-                if (mPlayStatusBinder.isPlaying()) {
+    mLinear.setOnClickListener(v -> {
-                    Song song = FileUtil.getSong();
+        // 如果当前有正在播放的歌曲（歌曲名称不为空），执行跳转操作
-                    song.setCurrentTime(mPlayStatusBinder.getCurrentTime());
+        if (FileUtil.getSong().getSongName()!= null) {
-                    FileUtil.saveSong(song);
+            Intent toPlayActivityIntent = new Intent(MainActivity.this, PlayActivity.class);
-                    toPlayActivityIntent.putExtra(Constant.PLAYER_STATUS, Constant.SONG_PLAY);
-                } else {
-                    //暂停情况
-                    Song song = FileUtil.getSong();
-                    song.setCurrentTime(mSeekBar.getProgress());
-                    FileUtil.saveSong(song);
-                }
-                if (FileUtil.getSong().getImgUrl() != null) {
-                    toPlayActivityIntent.putExtra(SearchContentFragment.IS_ONLINE, true);
-                }
-                //如果版本大于21
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
-                    startActivity(toPlayActivityIntent,
-                            ActivityOptions.makeSceneTransitionAnimation(MainActivity.this).toBundle());
-                } else {
-                    startActivity(toPlayActivityIntent);
-                }
 
+            // 如果PlayerService正在播放歌曲，获取当前歌曲对象，设置当前播放时间，并将播放状态设置为正在播放（Constant.SONG_PLAY）传递给目标Activity
+            if (mPlayStatusBinder.isPlaying()) {
+                Song song = FileUtil.getSong();
+                song.setCurrentTime(mPlayStatusBinder.getCurrentTime());
+                FileUtil.saveSong(song);
+                toPlayActivityIntent.putExtra(Constant.PLAYER_STATUS, Constant.SONG_PLAY);
             } else {
-                showToast(getString(R.string.welcome_start));
+                // 如果歌曲处于暂停状态，获取当前歌曲对象，将SeekBar当前进度作为歌曲当前播放时间设置给歌曲对象，并保存
+                Song song = FileUtil.getSong();
+                song.setCurrentTime(mSeekBar.getProgress());
+                FileUtil.saveSong(song);
+            }
+            // 如果歌曲封面图片的URL不为空，说明是在线歌曲，传递一个标识（SearchContentFragment.IS_ONLINE为true）给目标Activity
+            if (FileUtil.getSong().getImgUrl()!= null) {
+                toPlayActivityIntent.putExtra(SearchContentFragment.IS_ONLINE, true);
+            }
+            // 如果系统版本大于等于LOLLIPOP（Android 5.0），使用转场动画启动目标Activity
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+                startActivity(toPlayActivityIntent,
+                        ActivityOptions.makeSceneTransitionAnimation(MainActivity.this).toBundle());
+            } else {
+                // 如果系统版本小于Android 5.0，直接启动目标Activity
+                startActivity(toPlayActivityIntent);
             }
-        });
-    }
 
+        } else {
+            // 如果没有正在播放的歌曲，弹出一个提示Toast（显示默认的欢迎开始之类的文本）
+            showToast(getString(R.string.welcome_start));
+        }
+    });
+}
+
+    // 添加主界面的Fragment到Activity中的方法
     private void addMainFragment() {
+        // 创建MainFragment实例
         MainFragment mainFragment = new MainFragment();
+        // 获取FragmentManager对象，用于管理Fragment事务
         FragmentManager fragmentManager = getSupportFragmentManager();
+        // 开启Fragment事务
         FragmentTransaction transaction = fragmentManager.beginTransaction();
+        // 将MainFragment添加到指定的布局容器（R.id.fragment_container）中
         transaction.add(R.id.fragment_container, mainFragment);
+        // 提交Fragment事务，使添加操作生效
         transaction.commit();
     }
 
-
+    // 启动SeekBar进度更新的方法，创建并启动一个线程来更新SeekBar的进度显示
     private void seekBarStart() {
         mSeekBarThread = new Thread(new SeekBarThread());
         mSeekBarThread.start();
     }
 
+    // 实现了Runnable接口的内部类，用于在后台线程中更新SeekBar的进度显示
     class SeekBarThread implements Runnable {
         @Override
         public void run() {
-            if (mPlayStatusBinder != null) {
+            // 只要没有正在拖动进度条且PlayerService正在播放歌曲，就持续更新SeekBar的进度
+            if (mPlayStatusBinder!= null) {
                 while (!isChange && mPlayStatusBinder.isPlaying()) {
+                    // 设置SeekBar的进度为从PlayerService获取到的当前播放时间（单位可能需要和SeekBar的进度单位一致，这里看起来是以秒为单位）
                     mSeekBar.setProgress((int) mPlayStatusBinder.getCurrentTime());
                     try {
+                        // 线程休眠1秒，模拟每秒更新一次进度
                         Thread.sleep(1000);
                     } catch (InterruptedException e) {
                         e.printStackTrace();

app/src/main/java/com/example/musicplayer/view/WelcomeActivity.java

@@ -18,46 +18,61 @@ import com.example.musicplayer.R;
 import com.example.musicplayer.adapter.SongAdapter;
 import com.example.musicplayer.util.CommonUtil;
 
+// WelcomeActivity类继承自AppCompatActivity，是安卓应用中用于展示欢迎界面的Activity类，
+// 在这里主要负责处理欢迎界面相关的初始化操作、权限申请以及跳转到主界面的逻辑。
 public class WelcomeActivity extends AppCompatActivity {
 
-
+    // 重写onCreate方法，该方法在Activity创建时被调用，用于进行各种初始化操作，例如设置界面布局、申请权限等。
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        CommonUtil.hideStatusBar(this,true);
+        // 调用工具类CommonUtil中的方法隐藏状态栏，传入true表示隐藏状态栏，使欢迎界面能够全屏展示（具体效果取决于CommonUtil中方法的实现逻辑）。
+        CommonUtil.hideStatusBar(this, true);
+        // 将窗口的背景Drawable设置为null，可能是为了实现某种特定的背景效果（比如透明背景等，具体需结合应用整体的UI设计来看）。
         getWindow().setBackgroundDrawable(null);
+        // 设置该Activity的界面布局为activity_welcome，通过加载对应的布局资源文件来定义界面的外观和包含的控件等内容。
         setContentView(R.layout.activity_welcome);
 
-        //申请权限
+        // 申请权限部分，检查应用是否已经获取了写入外部存储的权限（Manifest.permission.WRITE_EXTERNAL_STORAGE）。
+        // 如果没有获取到该权限（ContextCompat.checkSelfPermission返回的结果不等于PackageManager.PERMISSION_GRANTED），
+        // 则通过ActivityCompat.requestPermissions方法向用户请求该权限，传入当前Activity实例、需要请求的权限数组（这里只请求了写入外部存储权限）以及请求码（用于在权限申请结果回调中区分不同的权限申请）。
         if (ContextCompat.checkSelfPermission(WelcomeActivity.this, Manifest.permission.
-                WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
+                WRITE_EXTERNAL_STORAGE)!= PackageManager.PERMISSION_GRANTED) {
             ActivityCompat.requestPermissions(WelcomeActivity.this, new String[]{
                     Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1);
         } else {
+            // 如果已经获取了写入外部存储的权限，通过Handler发送一个延迟消息，延迟2000毫秒（2秒）后执行相应操作，这里会调用getHome方法跳转到主界面。
             mHandler.sendEmptyMessageDelayed(0, 2000);
         }
     }
 
+    // 创建一个Handler对象，用于处理消息，在这里主要用于在合适的时机（延迟2秒后或者权限申请成功后）执行跳转到主界面的操作。
     private Handler mHandler = new Handler() {
         @Override
         public void handleMessage(Message msg) {
+            // 调用getHome方法，该方法用于启动主界面Activity并关闭当前的欢迎界面Activity，实现页面跳转。
             getHome();
             super.handleMessage(msg);
         }
     };
 
+    // 定义getHome方法，用于启动主界面Activity（MainActivity）并关闭当前的欢迎界面Activity，实现从欢迎界面跳转到应用主界面的功能。
     private void getHome() {
         startActivity(new Intent(WelcomeActivity.this, MainActivity.class));
         finish();
     }
 
+    // 重写onRequestPermissionsResult方法，该方法用于处理权限申请的结果回调，根据用户是否授予权限来执行不同的逻辑。
     @Override
     public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
         switch (requestCode) {
             case 1:
+                // 如果请求码为1（对应之前请求写入外部存储权限时设置的请求码），并且权限授予结果数组长度大于0，且第一个元素（对应写入外部存储权限的授予结果）为PackageManager.PERMISSION_GRANTED（表示权限已授予），
+                // 则通过Handler发送一个延迟消息，延迟2000毫秒（2秒）后执行相应操作，这里同样会调用getHome方法跳转到主界面。
                 if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                     mHandler.sendEmptyMessageDelayed(0, 2000);
                 } else {
+                    // 如果权限被拒绝，通过Toast显示一个提示信息，告知用户拒绝该权限将无法使用程序，然后调用finish方法关闭当前的欢迎界面Activity。
                     Toast.makeText(this, "拒绝该权限无法使用该程序", Toast.LENGTH_SHORT).show();
                     finish();
                 }

app/src/main/java/com/example/musicplayer/view/main/MainFragment.java

@@ -1,6 +1,5 @@
 package com.example.musicplayer.view.main;
 
-
 import android.os.Bundle;
 import android.support.v4.app.Fragment;
 import android.support.v4.app.FragmentManager;
@@ -39,139 +38,226 @@ import java.util.List;
 
 /**
  * A simple {@link Fragment} subclass.
+ * 这个类表示主界面的Fragment，作为音乐播放器主界面的主要展示和交互区域，
+ * 包含了展示歌单列表、各种音乐分类入口（如本地音乐、收藏、下载、历史播放等），
+ * 能够响应相关事件（如收藏歌单变化、不同类型歌曲数量变化等），并处理各部分的点击交互逻辑。
  */
 public class MainFragment extends Fragment {
 
     private static final String TAG = "MainFragment";
 
+    // 自定义的可展开列表视图组件，用于展示如自建歌单、收藏歌单等相关歌单信息，支持分组展开和收缩查看详情
     private MyListView myListView;
+    // 可展开列表视图的适配器，负责将歌单数据（分组及子项数据）适配到MyListView上进行展示，并处理相关点击等交互逻辑
     private ExpandableListViewAdapter mAdapter;
-    private LinearLayout mLocalMusicLinear, mCollectionLinear, mHistoryMusicLinear,mDownloadLinear;
+    // 用于展示本地音乐入口的线性布局，点击可进入本地音乐相关界面，方便用户操作
-    private TextView mLocalMusicNum, mLoveMusicNum, mHistoryMusicNum,mDownloadMusicNum;
+    private LinearLayout mLocalMusicLinear,
+    // 用于展示收藏歌单入口的线性布局，点击可进入收藏歌单相关界面
+            mCollectionLinear,
+    // 用于展示历史播放音乐入口的线性布局，点击可进入历史播放音乐相关界面
+            mHistoryMusicLinear,
+    // 用于展示下载音乐入口的线性布局，点击可进入下载音乐相关界面
+            mDownloadLinear;
+    // 用于显示本地音乐数量的TextView组件，实时展示本地音乐的数量情况
+    private TextView mLocalMusicNum,
+    // 用于显示收藏歌曲（例如“我喜欢”歌单中歌曲数量等）数量的TextView组件
+            mLoveMusicNum,
+    // 用于显示历史播放音乐数量的TextView组件
+            mHistoryMusicNum,
+    // 用于显示下载音乐数量的TextView组件
+            mDownloadMusicNum;
 
+    // 用于触发搜索操作的按钮（可能是一个TextView，样式上作为按钮使用），点击可进入搜索相关界面
     private TextView mSeekBtn;
+    // 存储歌单收藏信息的二维列表，外层列表按分组（如自建歌单、收藏歌单等）划分，内层列表存储每个分组下具体的歌单信息
     private List<List<AlbumCollection>> mAlbumCollectionList;
+    // 存储“我喜欢”歌单信息的列表，属于一种特殊的收藏歌单，单独列出方便操作和展示
     private List<AlbumCollection> mLoveAlbumList;
+    // 用于标记歌单展开和收缩状态的布尔变量，用于判断二级歌单展开或收缩的操作逻辑，辅助更新界面展示
     private boolean twoExpand;
+    // 定义可展开列表视图中分组标题的字符串数组，这里包含了"自建歌单"和"收藏歌单"两个分组标题
     private String[] mGroupStrings = {"自建歌单", "收藏歌单"};
 
-
+    /**
+     * 创建Fragment的视图，加载对应的布局文件，获取布局中的各个视图组件，
+     * 同时注册到EventBus用于接收相关事件（如歌单更新、歌曲数量变化等事件）。
+     * @param inflater 用于将布局文件实例化为视图对象的布局填充器
+     * @param container 父视图容器
+     * @param savedInstanceState 保存的实例状态信息（如果有的话）
+     * @return 返回创建好的视图对象
+     */
     @Override
     public View onCreateView(LayoutInflater inflater, ViewGroup container,
                              Bundle savedInstanceState) {
+        // 注册当前Fragment到EventBus，用于接收事件（例如歌单收藏变化、不同类型歌曲数量变化等事件，用于更新界面等操作）
         EventBus.getDefault().register(this);
+        // 加载fragment_main布局文件并创建视图对象
         View view = inflater.inflate(R.layout.fragment_main, container, false);
+        // 从加载的布局中找到对应的本地音乐入口线性布局组件
         mLocalMusicLinear = view.findViewById(R.id.linear_local_music);
+        // 从加载的布局中找到对应的收藏歌单入口线性布局组件
         mCollectionLinear = view.findViewById(R.id.linear_collection);
+        // 从加载的布局中找到对应的功能区线性布局组件（从代码中看可能用于整体获取焦点等操作，具体作用看业务逻辑）
         LinearLayout mFunctionLinear = view.findViewById(R.id.linear_function);
+        // 从加载的布局中找到对应的历史播放音乐入口线性布局组件
         mHistoryMusicLinear = view.findViewById(R.id.linear_history);
-        //获取焦点
+        // 设置功能区线性布局可在触摸模式下获取焦点，可能用于处理焦点相关交互逻辑（比如键盘操作等场景下焦点管理）
         mFunctionLinear.setFocusableInTouchMode(true);
+        // 从加载的布局中找到对应的可展开列表视图组件
         myListView = view.findViewById(R.id.expand_lv_song_list);
+        // 从加载的布局中找到对应的搜索按钮组件（这里是一个TextView作为按钮使用）
         mSeekBtn = view.findViewById(R.id.tv_seek);
+        // 从加载的布局中找到对应的本地音乐数量显示TextView组件
         mLocalMusicNum = view.findViewById(R.id.tv_local_music_num);
+        // 从加载的布局中找到对应的收藏歌曲数量显示TextView组件
         mLoveMusicNum = view.findViewById(R.id.tv_love_num);
+        // 从加载的布局中找到对应的历史播放音乐数量显示TextView组件
         mHistoryMusicNum = view.findViewById(R.id.tv_history_num);
+        // 从加载的布局中找到对应的下载音乐数量显示TextView组件
         mDownloadMusicNum = view.findViewById(R.id.tv_download_num);
+        // 从加载的布局中找到对应的下载音乐入口线性布局组件
         mDownloadLinear = view.findViewById(R.id.downloadLinear);
         return view;
     }
 
+    /**
+     * 当Fragment所在的Activity创建完成后调用，主要用于调用展示歌单列表的方法以及设置各种点击事件的监听逻辑，
+     * 完成界面的初始化展示和交互功能配置。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话）
+     */
     @Override
     public void onActivityCreated(Bundle savedInstanceState) {
         super.onActivityCreated(savedInstanceState);
+        // 调用方法展示歌单列表信息，包括创建数据集合、初始化数据、设置适配器等操作
         showAlbumList();
+        // 调用方法设置各种点击事件的监听逻辑，如不同音乐分类入口点击、歌单展开收缩点击、歌单项点击等操作
         onClick();
     }
 
+    /**
+     * 展示歌单列表信息的方法，初始化“我喜欢”歌单列表和整体歌单收藏列表，添加默认的“我喜欢”歌单信息，
+     * 从数据库获取其他收藏歌单信息并整理排序，创建可展开列表视图的适配器并设置给对应的视图组件，用于展示歌单列表。
+     */
     private void showAlbumList() {
+        // 创建用于存储“我喜欢”歌单信息的空列表
         mLoveAlbumList = new ArrayList<>();
+        // 创建用于存储整体歌单收藏信息（按分组划分）的二维空列表
         mAlbumCollectionList = new ArrayList<>();
+        // 创建一个AlbumCollection对象，用于表示“我喜欢”歌单的基本信息（这里设置了名称和歌手名称示例信息）
         AlbumCollection albumCollection = new AlbumCollection();
         albumCollection.setAlbumName("我喜欢");
         albumCollection.setSingerName("残渊");
+        // 将“我喜欢”歌单信息对象添加到对应的列表中
         mLoveAlbumList.add(albumCollection);
-        mAlbumCollectionList.add(mLoveAlbumList);
+        // 从数据库中查询获取所有的AlbumCollection（歌单收藏）数据，调用orderCollection方法对数据进行逆序排列整理，
+        // 然后添加到整体歌单收藏列表中作为“收藏歌单”分组下的数据
         mAlbumCollectionList.add(orderCollection(LitePal.findAll(AlbumCollection.class)));
+        // 创建可展开列表视图的适配器，传入当前Activity上下文、分组标题数组和整理好的歌单收藏列表数据，
+        // 用于将数据适配并展示到可展开列表视图上
         mAdapter = new ExpandableListViewAdapter(getActivity(), mGroupStrings, mAlbumCollectionList);
+        // 将创建好的适配器设置给可展开列表视图组件，使其能够展示歌单列表信息
         myListView.setAdapter(mAdapter);
     }
 
-
+    /**
+     * 当Fragment被销毁时调用，进行一些清理操作，如注销在EventBus的注册等，避免内存泄漏等问题，释放相关资源。
+     */
     @Override
     public void onDestroy() {
         super.onDestroy();
         EventBus.getDefault().unregister(this);
     }
 
+    /**
+     * 当Fragment开始可见时调用，主要用于调用展示不同类型音乐数量的方法，更新界面上各音乐分类的数量显示情况。
+     */
     @Override
     public void onStart() {
         super.onStart();
         showMusicNum();
     }
 
+    /**
+     * 订阅EventBus的事件，当接收到AlbumCollectionEvent类型的事件时，
+     * 先清空歌单收藏列表数据，重新添加“我喜欢”歌单信息和整理后的其他收藏歌单信息，
+     * 根据之前记录的歌单展开收缩状态，通过展开和收缩操作来更新可展开列表视图的展示内容，达到更新歌单列表的功能。
+     * @param event 接收到的AlbumCollectionEvent事件对象，可能包含了歌单收藏相关的变化信息（如新增、删除歌单等情况）
+     */
     @Subscribe(threadMode = ThreadMode.MAIN)
     public void onMessageEvent(AlbumCollectionEvent event) {
-            mAlbumCollectionList.clear();
+        mAlbumCollectionList.clear();
-            mAlbumCollectionList.add(mLoveAlbumList);
+        mAlbumCollectionList.add(mLoveAlbumList);
-            mAlbumCollectionList.add(orderCollection(LitePal.findAll(AlbumCollection.class)));
+        mAlbumCollectionList.add(orderCollection(LitePal.findAll(AlbumCollection.class)));
-            //根据之前的状态，进行展开和收缩，从而达到更新列表的功能
+        // 根据之前的状态，进行展开和收缩，从而达到更新列表的功能
-            if (twoExpand) {
+        if (twoExpand) {
-                myListView.collapseGroup(1);
+            myListView.collapseGroup(1);
-                myListView.expandGroup(1);
+            myListView.expandGroup(1);
-            } else {
+        } else {
-                myListView.expandGroup(1);
+            myListView.expandGroup(1);
-                myListView.collapseGroup(1);
+            myListView.collapseGroup(1);
-            }
+        }
     }
 
+    /**
+     * 订阅EventBus的事件，当接收到SongListNumEvent类型的事件时，根据事件中传递的类型标识，
+     * 更新对应类型音乐（历史播放、本地音乐、下载音乐）在界面上显示的数量信息，实时展示不同类型音乐的数量变化情况。
+     * @param event 接收到的SongListNumEvent事件对象，包含了音乐类型以及对应的数量变化相关信息
+     */
     @Subscribe(threadMode = ThreadMode.MAIN)
-    public void onSongListEvent(SongListNumEvent event){
+    public void onSongListEvent(SongListNumEvent event) {
         int type = event.getType();
-        if(type == Constant.LIST_TYPE_HISTORY){
+        if (type == Constant.LIST_TYPE_HISTORY) {
             mHistoryMusicNum.setText(String.valueOf(LitePal.findAll(HistorySong.class).size()));
-        }else if(type == Constant.LIST_TYPE_LOCAL){
+        } else if (type == Constant.LIST_TYPE_LOCAL) {
             mLocalMusicNum.setText(String.valueOf(LitePal.findAll(LocalSong.class).size()));
-        }else if(type == Constant.LIST_TYPE_DOWNLOAD){
+        } else if (type == Constant.LIST_TYPE_DOWNLOAD) {
             mDownloadMusicNum.setText(String.valueOf(DownloadUtil.getSongFromFile(Api.STORAGE_SONG_FILE).size()));
         }
     }
 
-
+    /**
-
+     * 设置各种点击事件的监听逻辑的方法，包括不同音乐分类入口点击、歌单展开收缩点击、歌单项点击等操作，
+     * 通过点击相应的布局或列表项实现界面的跳转、数据更新等交互功能。
+     */
     private void onClick() {
-        //本地音乐
+        // 为本地音乐入口线性布局设置点击事件监听，点击时跳转到本地音乐相关的Fragment（LocalFragment）
         mLocalMusicLinear.setOnClickListener(v -> replaceFragment(new LocalFragment()));
-        //搜索
+        // 为搜索按钮设置点击事件监听，点击时跳转到搜索相关的Fragment（AlbumContentFragment.SearchFragment）
         mSeekBtn.setOnClickListener(v -> replaceFragment(new AlbumContentFragment.SearchFragment()));
-        //我的收藏
+        // 为收藏歌单入口线性布局设置点击事件监听，点击时跳转到收藏歌单相关的Fragment（CollectionFragment）
         mCollectionLinear.setOnClickListener(v -> replaceFragment(new CollectionFragment()));
-        //下载
+        // 为下载音乐入口线性布局设置点击事件监听，点击时跳转到下载音乐相关的Fragment（DownloadFragment）
         mDownloadLinear.setOnClickListener(view -> replaceFragment(new DownloadFragment()));
-        //最近播放
+        // 为历史播放音乐入口线性布局设置点击事件监听，点击时跳转到历史播放音乐相关的Fragment（HistoryFragment）
         mHistoryMusicLinear.setOnClickListener(v -> replaceFragment(new HistoryFragment()));
 
-        //歌单点击展开
+        // 为可展开列表视图设置分组展开监听事件，当某个分组展开时，如果是二级分组（索引为1，对应“收藏歌单”分组）展开，
+        // 则将twoExpand标记设置为true，表示二级歌单处于展开状态
         myListView.setOnGroupExpandListener(groupPosition -> {
             if (groupPosition == 1) {
                 twoExpand = true;
             }
         });
 
-        //歌单点击收缩
+        // 为可展开列表视图设置分组收缩监听事件，当某个分组收缩时，如果是二级分组（索引为1，对应“收藏歌单”分组）收缩，
+        // 则将twoExpand标记设置为false，表示二级歌单处于收缩状态
         myListView.setOnGroupCollapseListener(groupPosition -> {
             if (groupPosition == 1) {
                 twoExpand = false;
             }
         });
+        // 为可展开列表视图设置分组点击事件监听，这里直接返回false，表示点击分组标题时不进行默认的展开收缩切换操作，
+        // 可能是为了自定义展开收缩逻辑或者避免与其他操作冲突，具体看业务需求
         myListView.setOnGroupClickListener((parent, v, groupPosition, id) -> false);
-        //二级列表的item点击效果
+
+        // 为可展开列表视图的适配器设置子项（二级列表项，即具体歌单项）点击事件监听，点击时根据点击的位置进行不同的界面跳转操作
         mAdapter.setOnChildItemClickListener((groupPosition, childPosition) -> {
-            //一级列表的第一个默认为我喜欢的歌单，故点击后跳转到我的收藏界面
+            // 如果点击的是一级列表的第一个子项（通常对应“我喜欢”歌单，索引为0），则跳转到收藏歌单相关的Fragment（CollectionFragment）
             if (groupPosition == 0 && childPosition == 0) {
                 replaceFragment(new CollectionFragment());
             } else if (groupPosition == 1) {
-                //其他的列表都是我的收藏的列表，故跳转到专辑详细fragment
+                // 如果点击的是二级列表中的其他项（对应“收藏歌单”分组下的具体歌单），则获取对应的歌单信息，
+                // 跳转到专辑详细信息展示的Fragment（AlbumContentFragment），并传递歌单相关参数（如ID、名称、封面等）用于展示详细内容
                 AlbumCollection albumCollection = mAlbumCollectionList.get(groupPosition).get(childPosition);
                 replaceFragment(AlbumContentFragment.newInstance(
                         albumCollection.getAlbumId(),
@@ -184,32 +270,58 @@ public class MainFragment extends Fragment {
         });
     }
 
-
+    /**
+     * 用于替换Fragment的方法，获取Activity的Fragment管理器，开启一个Fragment事务，
+     * 设置Fragment切换的动画效果，将传入的目标Fragment添加到指定的容器布局（R.id.fragment_container）中，
+     * 同时隐藏当前Fragment，并将事务添加到返回栈，以便用户可以通过返回键回到当前Fragment，最后提交事务完成切换操作。
+     * @param fragment 要替换展示的目标Fragment实例，决定了点击操作后跳转到的具体界面内容
+     */
     private void replaceFragment(Fragment fragment) {
         FragmentManager fragmentManager = getActivity().getSupportFragmentManager();
         FragmentTransaction transaction = fragmentManager.beginTransaction();
 
-        //进入和退出动画
+        // 设置Fragment进入和退出的动画效果，分别对应进入、退出、从右侧进入、从右侧退出的动画资源ID
         transaction.setCustomAnimations(R.anim.fragment_in, R.anim.fragment_out, R.anim.slide_in_right, R.anim.slide_out_right);
         transaction.add(R.id.fragment_container, fragment);
         transaction.hide(this);
-        //将事务提交到返回栈
+        // 将事务添加到返回栈，按下返回键时可以按照添加顺序反向执行事务，实现返回上一个Fragment的效果
         transaction.addToBackStack(null);
         transaction.commit();
     }
 
-    //显示数目
+    /**
+     * 展示不同类型音乐数量的方法，通过查询LitePal数据库获取本地音乐、收藏歌曲、历史播放音乐的数量，
+     * 以及通过特定工具方法获取下载音乐的数量，然后将数量信息更新到对应的TextView组件上进行显示，
+     * 实现实时展示各类型音乐数量情况的功能。
+     */
     private void showMusicNum() {
+        // 获取本地歌曲数量，通过LitePal框架查询本地歌曲（LocalSong类对应的数据库表）的所有记录数量，
+        // 将数量转换为字符串并设置到对应的TextView组件上进行显示
         mLocalMusicNum.setText(String.valueOf(LitePal.findAll(LocalSong.class).size()));
+        // 获取收藏歌曲（这里可能是“我喜欢”等收藏相关歌曲，Love类对应的数据库表）的数量，
+        // 通过LitePal框架查询所有记录数量，将数量转换为字符串并设置到对应的TextView组件上进行显示
         mLoveMusicNum.setText(String.valueOf(LitePal.findAll(Love.class).size()));
+        // 获取历史播放歌曲数量，通过LitePal框架查询历史播放歌曲（HistorySong类对应的数据库表）的所有记录数量，
+        // 将数量转换为字符串并设置到对应的TextView组件上进行显示
         mHistoryMusicNum.setText(String.valueOf(LitePal.findAll(HistorySong.class).size()));
+        // 获取下载歌曲数量，通过DownloadUtil工具类的特定方法（getSongFromFile方法，可能是从特定文件或存储位置获取下载歌曲信息）
+        // 获取下载歌曲列表，然后获取其数量，将数量转换为字符串并设置到对应的TextView组件上进行显示
         mDownloadMusicNum.setText(String.valueOf(DownloadUtil.getSongFromFile(Api.STORAGE_SONG_FILE).size()));
     }
 
-    //使数据库中的列表逆序排列
+    /**
+     * 使数据库中的列表逆序排列的方法，接收一个AlbumCollection类型的列表作为参数，
+     * 创建一个新的空列表，将传入列表中的元素从后往前（逆序）逐个添加到新列表中，最后返回整理后的逆序列表，
+     * 可用于对从数据库获取的歌单列表等数据按照特定顺序（如时间倒序等需求）进行展示。
+     * @param tempList 从数据库获取的原始AlbumCollection列表数据，需要进行逆序排列整理
+     * @return 返回逆序排列后的AlbumCollection列表数据
+     */
     private List<AlbumCollection> orderCollection(List<AlbumCollection> tempList) {
+        // 创建用于存储逆序排列后数据的空列表
         List<AlbumCollection> mAlbumCollectionList = new ArrayList<>();
+        // 从传入列表的最后一个元素开始，逆序循环遍历每个元素
         for (int i = tempList.size() - 1; i >= 0; i--) {
+            // 将当前元素添加到新创建的列表中
             mAlbumCollectionList.add(tempList.get(i));
         }
         return mAlbumCollectionList;

app/src/main/java/com/example/musicplayer/view/main/collection/CollectionFragment.java

@@ -1,6 +1,5 @@
 package com.example.musicplayer.view.main.collection;
 
-
 import android.content.ComponentName;
 import android.content.Context;
 import android.content.Intent;
@@ -36,106 +35,247 @@ import java.util.Objects;
 
 /**
  * Created by 残渊 on 2018/11/30.
+ * 这个类表示收藏歌曲列表展示的Fragment，用于展示用户收藏的歌曲相关信息，
+ * 可以与播放服务进行交互来实现播放收藏歌曲的功能，能响应歌曲收藏相关事件（如新增收藏、取消收藏等事件）以更新界面展示内容，
+ * 通过RecyclerView展示收藏歌曲的列表，并处理列表项的点击事件（如点击播放收藏歌曲等操作），
+ * 为用户提供管理和操作收藏歌曲的功能体验，是音乐播放器应用中收藏功能模块的重要部分。
  */
-
 public class CollectionFragment extends Fragment {
-    private static final String TAG="CollectionFragment";
+    private static final String TAG = "CollectionFragment";
 
+    // 用于展示收藏歌曲列表的RecyclerView组件，通过设置适配器等展示收藏歌曲的相关信息，
+    // 如歌曲名称、歌手等，同时支持列表项的点击等交互操作（如点击播放歌曲等），方便用户操作收藏的歌曲。
     private RecyclerView mRecycler;
+    // 用于返回上一界面的ImageView组件，通常点击该图标可实现返回功能，遵循常见的界面导航逻辑，
+    // 使得用户可以方便地回到之前浏览的页面，增强应用的操作便利性。
     private ImageView mBackIv;
+    // 用于管理RecyclerView布局的线性布局管理器，设置收藏歌曲列表的布局方式（如垂直排列等），
+    // 决定了列表项在RecyclerView中的排列顺序和滚动方式等展示效果，方便用户上下滑动查看不同的收藏歌曲信息。
     private LinearLayoutManager mManager;
+    // 收藏歌曲列表的适配器，负责将收藏歌曲的数据绑定到RecyclerView的每个Item视图上进行展示，
+    // 并处理相关点击等交互逻辑，例如设置每首歌曲在列表中的显示样式，以及响应点击播放等操作。
     private LoveSongAdapter mAdapter;
+    // 存储收藏歌曲信息（Love类型）的列表，用于展示以及后续的操作（如根据收藏相关事件更新列表内容、获取歌曲信息用于播放等），
+    // 该列表的数据会从数据库或者其他存储方式获取并填充，然后传递给适配器用于展示在界面上。
     private List<Love> mLoveList;
 
+    // 用于与播放服务进行交互的Binder对象，通过它可以调用播放服务中的方法，如播放收藏歌曲等操作，
+    // 在与服务成功连接后获取其实例，以便后续在需要播放歌曲时使用。
     private PlayerService.PlayStatusBinder mPlayStatusBinder;
+    // 定义与播放服务的连接对象，用于监听服务的连接与断开状态，并获取服务提供的Binder对象进行交互，
+    // 是实现Fragment与播放服务通信的关键部分，保障了相关播放服务功能（如播放收藏歌曲等）的正常调用，
+    // 确保Fragment能和播放服务协同工作，实现完整的收藏歌曲播放相关功能逻辑。
     private ServiceConnection connection = new ServiceConnection() {
+        /**
+         * 当与服务成功连接时调用，获取服务提供的IBinder对象，并强转为对应的PlayStatusBinder类型，
+         // 这一步是为了能通过强转后的对象调用播放服务中特定的、针对PlayStatusBinder类型定义的方法，
+         // 例如播放歌曲等操作对应的方法，从而实现对收藏歌曲的播放控制。
+         * @param name 连接的服务的组件名称，标识所连接的服务在系统中的唯一性，
+         // 可以通过这个名称来区分不同的服务，确保连接到正确的目标服务。
+         * @param service 服务返回的IBinder对象，通过它可以和服务进行交互通信，
+         // 是实现跨组件（Fragment与Service）交互的重要媒介，通过它可以调用服务端暴露的方法。
+         */
         @Override
         public void onServiceConnected(ComponentName name, IBinder service) {
             mPlayStatusBinder = (PlayerService.PlayStatusBinder) service;
         }
 
+        /**
+         * 当与服务意外断开连接时调用，这里暂时没有具体实现逻辑，可根据需求添加相关处理，
+         // 比如重新尝试连接、提示用户等操作，例如可以弹出一个Toast提示用户播放服务异常断开，
+         // 或者自动重新发起连接请求，以增强应用在面对服务异常情况时的稳定性和用户友好性。
+         * @param name 断开连接的服务的组件名称，用于识别是哪个服务断开了连接，
+         // 方便根据不同服务进行针对性的异常处理（如果有多个服务连接的情况）。
+         */
         @Override
         public void onServiceDisconnected(ComponentName name) {
 
         }
     };
 
+    /**
+     * 创建Fragment的视图，加载对应的布局文件，获取布局中的各个视图组件，
+     // 同时注册到EventBus用于接收相关事件（如歌曲收藏状态变化等事件），为后续操作做准备，
+     // 并创建一个空的收藏歌曲列表，用于后续填充收藏歌曲数据。
+     * @param inflater 用于将布局文件实例化为视图对象的布局填充器，
+     // 它依据给定的布局资源文件，解析并创建对应的视图层次结构，是Android中构建界面视图的重要工具。
+     * @param container 父视图容器，通常是Activity中用于承载Fragment视图的布局容器，
+     // Fragment的视图会被添加到这个容器中，以正确显示在Activity的界面上。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），
+     // 可以用于在Fragment重建（比如屏幕旋转等情况）时恢复之前的界面状态、数据等内容，保持用户体验的连贯性。
+     * @return 返回创建好的视图对象，该对象将作为Fragment的界面展示内容，添加到父视图容器中呈现给用户。
+     */
     @Override
     public View onCreateView(LayoutInflater inflater, ViewGroup container,
                              Bundle savedInstanceState) {
+        // 加载fragment_love布局文件并创建视图对象，这一步根据指定的布局资源ID（R.layout.fragment_love），
+        // 使用布局填充器将布局文件解析并实例化为一个视图层次结构对象。
         View mView = inflater.inflate(R.layout.fragment_love, container, false);
+        // 注册当前Fragment到EventBus，用于接收事件（例如歌曲新增收藏、取消收藏等相关事件），
+        // 这样当其他地方发布了与歌曲收藏相关的事件时，该Fragment能够接收到通知并做出相应的界面更新操作。
         EventBus.getDefault().register(this); //注册事件订阅者
+        // 从加载的布局中找到对应的用于展示收藏歌曲列表的RecyclerView组件，以便后续对其进行操作（如设置属性、添加适配器等）。
         mRecycler = mView.findViewById(R.id.recycler_love_songs);
+        // 从加载的布局中找到对应的返回上一界面的ImageView组件，方便后续设置点击事件等操作。
         mBackIv = mView.findViewById(R.id.iv_back);
+        // 创建一个空的收藏歌曲列表，后续将从数据库等途径获取收藏歌曲的详细信息并填充到该列表中。
         mLoveList = new ArrayList<>();
         return mView;
     }
 
+    /**
+     * 当Fragment所在的Activity创建完成后调用，主要用于启动播放服务并绑定服务以获取相关功能，
+     // 调用展示收藏歌曲列表的方法以及设置返回按钮点击事件监听的方法，完成界面的初始化及与播放服务建立通信连接，
+     // 为后续展示收藏歌曲列表以及播放歌曲操作做准备。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），可用于恢复之前的相关状态（如果有需要），
+     // 不过在当前代码中未体现具体的恢复逻辑，一般可以用于一些诸如之前已经获取到的部分收藏歌曲相关数据等情况的恢复。
+     */
     @Override
     public void onActivityCreated(Bundle savedInstanceState) {
         super.onActivityCreated(savedInstanceState);
-        //启动服务
+        // 创建启动播放服务的Intent对象，指定要启动的服务类为PlayerService，用于后续与播放服务的交互操作，
+        // Intent是Android中用于启动组件（如Activity、Service等）或者传递消息的重要机制，这里用于指定要启动的播放服务。
         Intent playIntent = new Intent(getActivity(), PlayerService.class);
+        // 绑定播放服务，通过传入的ServiceConnection对象（connection）监听服务连接状态，
+        // 并设置绑定模式为自动创建服务（如果服务未启动则自动启动），确保播放服务能正常运行并与Fragment建立通信连接，
+        // 这一步操作使得Fragment能够与播放服务进行双向通信，获取服务提供的功能并向服务传递相关指令（如播放歌曲等）。
         Objects.requireNonNull(getActivity()).bindService(playIntent, connection, Context.BIND_AUTO_CREATE);
+        // 调用方法展示收藏歌曲列表，包括从数据库获取数据、设置布局管理器、创建适配器以及设置列表项点击事件监听等操作，
+        // 使得RecyclerView能够正确展示收藏歌曲的相关信息，并能响应用户的点击播放等操作。
         showSongList();
+        // 调用方法设置返回按钮的点击事件监听，使得点击返回按钮时能够执行相应的返回上一界面的操作，遵循常见的界面导航逻辑。
         onClick();
     }
+
+    /**
+     * 当Fragment被销毁时调用，进行一些清理操作，如注销在EventBus的注册、解除与播放服务的绑定等，
+     // 避免内存泄漏等问题，释放相关资源，确保应用的稳定运行和资源合理利用，同时也符合Android组件生命周期管理的规范要求。
+     */
     @Override
-    public void onDestroy(){
+    public void onDestroy() {
         super.onDestroy();
+        // 注销当前Fragment在EventBus的注册，防止接收不必要的事件造成潜在的异常或者资源浪费等情况，
+        // 确保Fragment在不再需要接收事件时停止相关监听操作。
         EventBus.getDefault().unregister(this);
+        // 解除与播放服务的绑定，释放相关资源，避免因未正确关闭连接导致的资源泄漏问题。
         Objects.requireNonNull(getActivity()).unbindService(connection);
     }
 
+    /**
+     * 订阅EventBus的事件，当接收到SongCollectionEvent类型的事件时，根据事件中的相关信息进行相应的界面更新操作，
+     // 先清空收藏歌曲列表，再重新从数据库获取收藏歌曲数据填充列表，通知RecyclerView的适配器数据集已改变，触发界面刷新，
+     // 如果事件表示是新增收藏歌曲且当前有正在播放歌曲（通过FileUtil.getSong()判断），则将RecyclerView滚动到对应歌曲位置进行展示，
+     // 确保界面展示与实际收藏歌曲情况保持一致，能及时反映收藏歌曲的变化情况，并在合适情况下定位到相关歌曲位置。
+     * @param songCollectionEvent 接收到的SongCollectionEvent事件对象，包含了歌曲收藏相关的各种信息，
+     // 如是否是新增收藏（通过isLove()方法判断）等情况，根据这些信息来决定如何更新界面展示内容。
+     */
     @Subscribe(threadMode = ThreadMode.MAIN )
-    public void onMessageEvent(SongCollectionEvent songCollectionEvent){
+    public void onMessageEvent(SongCollectionEvent songCollectionEvent) {
         mLoveList.clear();
         mLoveList.addAll(orderList(LitePal.findAll(Love.class)));
         mAdapter.notifyDataSetChanged();
-        if(songCollectionEvent.isLove()){//定位歌曲
+        if (songCollectionEvent.isLove()) {//定位歌曲
-            if (FileUtil.getSong() != null) {
+            if (FileUtil.getSong()!= null) {
+                // 将RecyclerView滚动到指定位置，通过获取当前播放歌曲的位置信息（FileUtil.getSong().getPosition()），
+                // 并加上一定偏移量（这里是4），以合适的视觉效果展示歌曲所在位置，滚动高度依据RecyclerView自身高度进行调整，
+                // 实现当新增收藏歌曲且该歌曲正在播放时，在界面上定位到该歌曲的功能，方便用户查看。
                 mManager.scrollToPositionWithOffset(FileUtil.getSong().getPosition() + 4, mRecycler.getHeight());
             }
         }
     }
 
+    /**
+     * 展示收藏歌曲列表的方法，设置RecyclerView的尺寸固定属性，从数据库获取收藏歌曲数据并进行逆序排列整理，
+     * 创建收藏歌曲列表的适配器，创建线性布局管理器并设置给RecyclerView，最后将适配器设置给RecyclerView用于展示收藏歌曲记录列表，
+     * 同时为收藏歌曲列表的适配器设置列表项点击事件监听，点击时进行一系列歌曲相关信息的设置（如歌曲名称、歌手、播放地址等），
+     * 保存歌曲信息到本地，并调用播放服务的方法开始播放对应收藏歌曲，完成列表展示及点击播放功能的配置工作。
+     */
     private void showSongList() {
+        // 设置RecyclerView的尺寸固定属性为true，这样可以提高RecyclerView的性能，
+        // 避免在数据变化时重复计算尺寸等操作，适用于列表项尺寸相对固定的情况（如这里的歌曲列表）。
         mRecycler.setHasFixedSize(true);
+        // 调用orderList方法对从数据库获取的所有收藏歌曲数据（通过LitePal框架查询Love类对应的表数据）进行逆序排列整理，
+        // 逆序排列可能是为了按照某种特定顺序（如时间倒序等）展示收藏歌曲，更符合用户查看习惯。
         mLoveList.addAll(orderList(LitePal.findAll(Love.class)));
+        // 创建收藏歌曲列表的适配器，传入当前Activity上下文和整理后的收藏歌曲列表数据，用于将数据绑定到视图上展示，
+        // 适配器负责将数据与RecyclerView的视图项进行绑定，设置每个视图项的展示样式，并处理相关交互逻辑（如点击事件）。
         mAdapter = new LoveSongAdapter(getActivity(), mLoveList);
+        // 创建线性布局管理器，设置为垂直方向排列（默认情况），用于管理RecyclerView中收藏歌曲列表的布局展示，
+        // 确定列表项是垂直排列的，方便用户上下滑动查看不同的收藏歌曲信息，符合常见的列表展示习惯。
         mManager = new LinearLayoutManager(getActivity());
+        // 将线性布局管理器设置给RecyclerView，确定其布局方式，使得音乐列表能按照设定的方式展示，
+        // 确保RecyclerView的布局效果符合预期，方便用户查看和操作列表中的歌曲信息。
         mRecycler.setLayoutManager(mManager);
+        // 将创建好的适配器设置给RecyclerView，使其能够展示收藏歌曲记录列表，
+        // 这样RecyclerView就能依据适配器提供的数据和展示逻辑，将收藏歌曲的信息展示给用户了。
         mRecycler.setAdapter(mAdapter);
+        // 为收藏歌曲列表的适配器设置列表项点击事件监听，点击时进行以下操作，用于实现点击播放收藏歌曲的功能。
         mAdapter.setOnItemClickListener(new OnItemClickListener() {
             @Override
             public void onClick(int position) {
+                // 获取点击位置对应的收藏歌曲信息对象，以便后续提取该歌曲的各项详细信息进行相关操作。
                 Love love = mLoveList.get(position);
+                // 创建一个Song对象，用于设置当前点击歌曲的相关信息，方便后续保存和播放操作，
+                // 这个Song对象可能是应用中统一用于表示歌曲信息的实体类，整合了歌曲各方面的关键属性。
                 Song song = new Song();
+                // 设置歌曲的唯一标识，通常在数据库或者整个应用体系中有唯一性，用于准确区分不同歌曲。
                 song.setSongId(love.getSongId());
+                // 设置歌曲的QQ标识（可能用于和QQ音乐等相关平台交互或者区分来源等情况，具体依据应用逻辑）。
                 song.setQqId(love.getQqId());
+                // 设置歌曲的名称，用于在界面展示以及后续可能的查找、排序等操作中使用，方便用户识别歌曲。
                 song.setSongName(love.getName());
+                // 设置歌曲的演唱者信息，同样有助于用户明确歌曲来源以及在界面展示等场景中提供更详细的歌曲描述。
                 song.setSinger(love.getSinger());
+                // 设置歌曲是否为在线歌曲的标识，根据收藏歌曲记录中的对应属性进行赋值，
+                // 后续可能根据这个标识来决定播放时的获取方式（如在线播放还是本地播放等）。
                 song.setOnline(love.isOnline());
+                // 设置歌曲的播放地址，这是实际播放歌曲时需要的关键信息，播放服务会依据这个地址来获取音频资源进行播放。
                 song.setUrl(love.getUrl());
+                // 设置歌曲的封面图片地址（如果有的话），可用于在界面展示歌曲时显示对应的封面图片，提升视觉效果和用户体验。
                 song.setImgUrl(love.getPic());
+                // 设置歌曲在列表中的位置索引，方便记录当前点击歌曲在列表中的顺序等相关操作，比如定位播放位置等。
                 song.setPosition(position);
+                // 设置歌曲的时长信息，用于在界面展示歌曲时长或者进行一些与时长相关的操作（如播放进度计算等）。
                 song.setDuration(love.getDuration());
+                // 设置歌曲的媒体资源唯一标识（可能用于更细致地区分不同版本或者来源的媒体资源等情况）。
                 song.setMediaId(love.getMediaId());
+                // 设置歌曲所属的列表类型为收藏类型，用于标识歌曲来源或者在应用中进行分类管理等操作，
+                // 例如在不同的播放逻辑或者统计场景下可以依据这个类型进行区分处理。
                 song.setListType(Constant.LIST_TYPE_LOVE);
+                // 通过FileUtil工具类将歌曲相关信息保存到本地，具体保存的方式和位置由FileUtil的实现决定，
+                // 可能是保存到本地文件或者数据库中，方便后续操作（如记录播放历史、恢复播放状态等），
+                // 确保应用能持久化用户的操作记录以及播放相关信息，提升用户体验的连贯性。
                 FileUtil.saveSong(song);
 
+                // 通过获取到的与播放服务交互的Binder对象（mPlayStatusBinder）调用播放服务中的播放方法，
+                // 传入Constant.LIST_TYPE_LOVE表示播放的是收藏类型的歌曲，从而实现点击收藏歌曲列表中的歌曲后进行播放的功能。
                 mPlayStatusBinder.play(Constant.LIST_TYPE_LOVE);
             }
         });
     }
 
+    /**
+     * 设置返回按钮点击事件监听的方法，为绑定的返回上一界面的ImageView设置点击事件监听，
+     * 点击时通过Fragment管理器弹出当前Fragment所在的栈，返回上一界面，遵循常见的界面导航逻辑，
+     * 方便用户在界面间进行切换操作，使得用户可以按照自己的浏览路径方便地回退，提升应用的易用性。
+     */
     private void onClick() {
         mBackIv.setOnClickListener(v -> getActivity().getSupportFragmentManager().popBackStack());
     }
-    private List<Love> orderList(List<Love> tempList){
+
-        List<Love> loveList=new ArrayList<>();
+    /**
+     * 对传入的收藏歌曲列表数据进行逆序排列的方法，创建一个新的空列表，
+     * 将传入列表中的元素从后往前（逆序）逐个添加到新列表中，最后返回整理后的逆序列表，
+     * 可用于按照时间倒序等需求展示收藏歌曲记录，使得最新收藏的歌曲排在列表前面等展示效果，更符合用户查看习惯。
+     * @param tempList 从数据库等获取的原始收藏歌曲列表数据，需要进行逆序排列整理，
+     *                 它包含了从数据库获取到的所有收藏歌曲的信息集合，但是顺序可能不符合展示需求，需要进行调整。
+     * @return 返回逆序排列后的收藏歌曲列表数据，这个返回的列表将用于后续在界面上展示收藏歌曲，
+     *         以更合理的顺序呈现给用户，方便用户快速找到最近收藏的歌曲等操作。
+     */
+    private List<Love> orderList(List<Love> tempList) {
+        List<Love> loveList = new ArrayList<>();
         loveList.clear();
-        for(int i=tempList.size()-1;i>=0;i--){
+        for (int i = tempList.size() - 1; i >= 0; i--) {
             loveList.add(tempList.get(i));
         }
         return loveList;

app/src/main/java/com/example/musicplayer/view/main/download/DownloadFragment.java

@@ -29,46 +29,115 @@ import butterknife.Unbinder;
  *     time   : 2019/09/16
  *     desc   : 下载模块
  * </pre>
+ * 这个类表示音乐播放器应用中下载功能的整体展示Fragment，作为下载模块的入口界面，
+ * 它整合了已下载歌曲和正在下载歌曲两个不同状态歌曲展示的相关Fragment，通过TabLayout与ViewPager的组合，
+ * 实现了以选项卡形式切换不同下载状态歌曲列表的功能，同时处理返回按钮的点击事件，方便用户在该模块内进行导航操作，
+ * 为用户提供了统一管理下载相关内容的交互界面。
  */
-
 public class DownloadFragment extends Fragment {
+    // 通过ButterKnife框架绑定的返回上一界面的ImageView组件，点击该图标可实现返回功能，
+    // 遵循常见的界面导航逻辑，让用户可以方便地回到之前浏览的页面，增强应用的操作便利性。
     @BindView(R.id.backIv)
     ImageView backIv;
+    // 通过ButterKnife框架绑定的TabLayout组件，用于展示选项卡，在这里它将提供不同下载状态（如已下载、正在下载）的切换标签，
+    // 用户可以通过点击不同标签切换到对应的下载歌曲列表展示页面，实现多页面切换展示的交互功能。
     @BindView(R.id.tabLayout)
     TabLayout tabLayout;
+    // 通过ButterKnife框架绑定的ViewPager组件，它与TabLayout配合使用，用于承载和切换不同的Fragment页面，
+    // 根据TabLayout中选中的标签来展示对应的Fragment（如展示已下载歌曲列表的Fragment或者正在下载歌曲列表的Fragment），
+    // 提供了流畅的页面切换视觉效果和交互体验。
     @BindView(R.id.page)
     ViewPager page;
+    // 用于解除ButterKnife框架绑定的对象，在合适的时机（如Fragment销毁时）需要调用其unbind方法来释放相关资源，避免内存泄漏。
     private Unbinder unbinder;
+    // 存储选项卡标题文本的列表，用于设置TabLayout中每个选项卡显示的标题内容，
+    // 这里的标题对应不同的下载状态，比如“已下载”“正在下载”等，方便用户直观了解每个标签对应的功能和展示内容。
     private List<String> mTitleList;
+    // 存储要在ViewPager中展示的Fragment的列表，每个Fragment代表了不同下载状态歌曲列表的展示页面，
+    // 通过将对应的Fragment添加到该列表中，ViewPager就能根据用户在TabLayout中的选择切换展示不同的Fragment页面。
     private List<Fragment> mFragments;
+    // 用于ViewPager的适配器，负责将Fragment列表与对应的标题列表关联起来，并管理ViewPager中Fragment页面的展示与切换逻辑，
+    // 它继承自合适的Adapter类（此处是自定义的TabAdapter），实现了将数据（Fragment和标题）适配到ViewPager组件上的功能。
     private TabAdapter mAdapter;
+    // 定义了选项卡标题的字符串数组，包含了要在TabLayout中显示的各个选项卡的标题文本内容，
+    // 这里明确了有两个选项卡，分别对应“已下载”和“正在下载”两种下载歌曲的状态分类，方便后续初始化TabLayout时使用。
     private String[] mTitles = {"已下载", "正在下载"};
 
+    /**
+     * 创建Fragment的视图，加载对应的布局文件，通过ButterKnife框架绑定视图组件，
+     * 调用初始化选项卡相关设置的方法以及设置返回按钮点击事件监听的方法，为展示下载模块界面及交互功能做准备，
+     * 最后返回创建好的视图对象，该对象将作为Fragment的界面展示内容，添加到父视图容器中呈现给用户。
+     *
+     * @param inflater           用于将布局文件实例化为视图对象的布局填充器，
+     *                           它依据给定的布局资源文件，解析并创建对应的视图层次结构，是Android中构建界面视图的重要工具。
+     * @param container          父视图容器，通常是Activity中用于承载Fragment视图的布局容器，
+     *                           Fragment的视图会被添加到这个容器中，以正确显示在Activity的界面上。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），
+     *                           可以用于在Fragment重建（比如屏幕旋转等情况）时恢复之前的界面状态、数据等内容，保持用户体验的连贯性。
+     * @return 返回创建好的视图对象，该对象将作为Fragment的界面展示内容，添加到父视图容器中呈现给用户。
+     */
     @Nullable
     @Override
     public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
+        // 加载fragment_download布局文件并创建视图对象，这一步根据指定的布局资源ID（R.layout.fragment_download），
+        // 使用布局填充器将布局文件解析并实例化为一个视图层次结构对象。
         View view = inflater.inflate(R.layout.fragment_download, container, false);
+        // 通过ButterKnife框架将视图与代码中的变量进行绑定，使得可以方便地操作布局中的视图组件，
+        // 例如通过绑定后的变量来设置ImageView、TabLayout、ViewPager等组件的属性、添加点击事件监听等操作。
         unbinder = ButterKnife.bind(this, view);
+        // 调用方法初始化TabLayout和ViewPager相关设置，包括创建标题列表、添加要展示的Fragment、创建适配器以及关联TabLayout与ViewPager等操作，
+        // 完成下载模块界面中选项卡切换展示不同下载状态歌曲列表的初始化配置工作。
         initTab();
+        // 调用方法设置返回按钮的点击事件监听，使得点击返回按钮时能够执行相应的返回上一界面的操作，遵循常见的界面导航逻辑。
         onClick();
         return view;
 
     }
 
+    /**
+     * 初始化TabLayout和ViewPager相关设置的方法，创建标题列表和Fragment列表，
+     * 将预先定义好的选项卡标题添加到标题列表中，把代表已下载歌曲列表和正在下载歌曲列表的Fragment添加到Fragment列表中，
+     * 创建用于ViewPager的适配器并传入Fragment管理器、Fragment列表以及标题列表进行初始化，
+     * 设置ViewPager的适配器，最后将TabLayout与ViewPager进行关联，使得选项卡切换能正确控制ViewPager中Fragment页面的切换展示，
+     * 完成下载模块界面中选项卡与对应Fragment页面交互展示的初始化配置工作。
+     */
     private void initTab() {
+        // 创建一个空的用于存储选项卡标题文本的列表，后续将添加具体的标题内容（如“已下载”“正在下载”等）到该列表中。
         mTitleList = new ArrayList<>();
+        // 创建一个空的用于存储要在ViewPager中展示的Fragment的列表，后续将添加对应的Fragment实例到该列表中。
         mFragments = new ArrayList<>();
+        // 将预先定义好的选项卡标题字符串数组转换为列表形式，并添加到标题列表中，这样标题列表就包含了所有要在TabLayout中显示的标题内容，
+        // 用于后续设置TabLayout的各个选项卡的标题文本。
         mTitleList.addAll(Arrays.asList(mTitles));
+        // 创建一个代表已下载歌曲列表展示的Fragment实例，并添加到Fragment列表中，该Fragment负责展示已下载完成的歌曲相关信息及操作界面。
         mFragments.add(new DownloadMusicFragment());
+        // 创建一个代表正在下载歌曲列表展示的Fragment实例，并添加到Fragment列表中，该Fragment负责展示正在下载的歌曲相关信息及操作界面。
         mFragments.add(new DownloadingFragment());
+        // 创建用于ViewPager的适配器，传入当前Fragment的子Fragment管理器（通过getChildFragmentManager方法获取）、
+        // Fragment列表以及标题列表，用于将这些数据关联起来，实现管理ViewPager中Fragment页面展示与切换的功能。
         mAdapter = new TabAdapter(getChildFragmentManager(), mFragments, mTitleList);
+        // 将创建好的适配器设置给ViewPager，使得ViewPager能够依据适配器提供的信息来展示和切换不同的Fragment页面，
+        // 确定了ViewPager展示内容的来源和切换逻辑。
         page.setAdapter(mAdapter);
+        // 将TabLayout与ViewPager进行关联，使得TabLayout中的选项卡切换操作能够同步控制ViewPager中Fragment页面的切换展示，
+        // 实现用户点击不同选项卡就能看到对应下载状态歌曲列表的交互功能，确保两者协同工作，提供流畅的界面切换体验。
         tabLayout.setupWithViewPager(page);
     }
-    private void onClick(){
+
+    /**
+     * 设置返回按钮点击事件监听的方法，为绑定的返回上一界面的ImageView设置点击事件监听，
+     * 点击时通过Fragment管理器弹出当前Fragment所在的栈，返回上一界面，遵循常见的界面导航逻辑，
+     * 方便用户在界面间进行切换操作，使得用户可以按照自己的浏览路径方便地回退，提升应用的易用性。
+     */
+    private void onClick() {
         backIv.setOnClickListener(view -> Objects.requireNonNull(getActivity()).getSupportFragmentManager().popBackStack());
     }
 
+    /**
+     * 当Fragment的视图即将被销毁时调用，进行一些清理操作，如解除ButterKnife框架的绑定，
+     * 释放相关资源，避免因未正确解除绑定关系导致的内存泄漏问题，确保应用的稳定运行和资源合理利用，
+     * 同时也符合Android组件生命周期管理的规范要求。
+     */
     @Override
     public void onDestroyView() {
         super.onDestroyView();

app/src/main/java/com/example/musicplayer/view/main/download/DownloadMusicFragment.java

@@ -47,103 +47,238 @@ import static com.example.musicplayer.app.Api.STORAGE_SONG_FILE;
  *     time   : 2019/09/16
  *     desc   : 下载歌曲列表
  * </pre>
+ * 这个类表示下载歌曲列表展示的Fragment，用于展示已经下载完成的歌曲相关信息，
+ * 可以与播放服务进行交互来实现播放已下载歌曲的功能，能响应下载相关事件（如歌曲下载成功等事件）以更新界面展示内容，
+ * 通过RecyclerView展示下载歌曲的列表，并处理列表项的点击事件（如点击播放已下载歌曲等操作），
+ * 为用户提供管理和操作已下载歌曲的功能体验，是音乐播放器应用中下载功能模块用于展示已下载歌曲的重要部分。
  */
-
 public class DownloadMusicFragment extends Fragment {
     private static final String TAG = "DownloadMusicFragment";
 
+    // 通过ButterKnife框架绑定的RecyclerView视图组件，用于展示已下载歌曲的列表，
+    // 可以展示每首已下载歌曲的相关信息（如歌曲名称、歌手等），并支持列表项的点击等交互操作（如点击播放歌曲等）。
     @BindView(R.id.songRecycle)
     RecyclerView songRecycle;
+    // 用于解除ButterKnife框架绑定的对象，在合适的时机（如Fragment销毁时）需要调用其unbind方法来释放相关资源，避免内存泄漏。
     Unbinder unbinder;
 
+    // 用于管理RecyclerView布局的线性布局管理器，设置已下载歌曲列表的布局方式（如垂直排列等），
+    // 决定了列表项在RecyclerView中的排列顺序和滚动方式等展示效果，方便用户上下滑动查看不同的已下载歌曲信息。
     private LinearLayoutManager mManager;
+    // 下载歌曲列表的适配器，负责将已下载歌曲的数据绑定到RecyclerView的每个Item视图上进行展示，
+    // 并处理相关点击等交互逻辑，例如设置每首歌曲在列表中的显示样式，以及响应点击播放等操作。
     private DownloadSongAdapter mAdapter;
+    // 存储已下载歌曲信息（DownloadSong类型）的列表，用于展示以及后续的操作（如根据下载相关事件更新列表内容、获取歌曲信息用于播放等），
+    // 该列表的数据会从本地文件或者通过相关工具类获取并填充，然后传递给适配器用于展示在界面上。
     private List<DownloadSong> mDownloadSongList;  //已下载歌曲列表
 
+    // 用于与播放服务进行交互的Binder对象，通过它可以调用播放服务中的方法，如播放已下载歌曲等操作，
+    // 在与服务成功连接后获取其实例，以便后续在需要播放歌曲时使用。
     private PlayerService.PlayStatusBinder mPlayStatusBinder;
+    // 定义与播放服务的连接对象，用于监听服务的连接与断开状态，并获取服务提供的Binder对象进行交互，
+    // 是实现Fragment与播放服务通信的关键部分，保障了相关播放服务功能（如播放已下载歌曲等）的正常调用，
+    // 确保Fragment能和播放服务协同工作，实现完整的已下载歌曲播放相关功能逻辑。
     private ServiceConnection connection = new ServiceConnection() {
+        /**
+         * 当与服务成功连接时调用，获取服务提供的IBinder对象，并强转为对应的PlayStatusBinder类型，
+         // 这一步是为了能通过强转后的对象调用播放服务中特定的、针对PlayStatusBinder类型定义的方法，
+         // 例如播放歌曲等操作对应的方法，从而实现对已下载歌曲的播放控制。
+         * @param name 连接的服务的组件名称，标识所连接的服务在系统中的唯一性，
+         // 可以通过这个名称来区分不同的服务，确保连接到正确的目标服务。
+         * @param service 服务返回的IBinder对象，通过它可以和服务进行交互通信，
+         // 是实现跨组件（Fragment与Service）交互的重要媒介，通过它可以调用服务端暴露的方法。
+         */
         @Override
         public void onServiceConnected(ComponentName name, IBinder service) {
             mPlayStatusBinder = (PlayerService.PlayStatusBinder) service;
         }
 
+        /**
+         * 当与服务意外断开连接时调用，这里暂时没有具体实现逻辑，可根据需求添加相关处理，
+         // 比如重新尝试连接、提示用户等操作，例如可以弹出一个Toast提示用户播放服务异常断开，
+         // 或者自动重新发起连接请求，以增强应用在面对服务异常情况时的稳定性和用户友好性。
+         * @param name 断开连接的服务的组件名称，用于识别是哪个服务断开了连接，
+         // 方便根据不同服务进行针对性的异常处理（如果有多个服务连接的情况）。
+         */
         @Override
         public void onServiceDisconnected(ComponentName name) {
 
         }
     };
 
+    /**
+     * 创建Fragment的视图，加载对应的布局文件，获取布局中的各个视图组件，
+     // 同时注册到EventBus用于接收相关事件（如歌曲下载成功、已下载歌曲有更新等事件），
+     // 并通过ButterKnife框架将视图与代码中的变量进行绑定，还创建了一个空的已下载歌曲列表，为后续操作做准备。
+     * @param inflater 用于将布局文件实例化为视图对象的布局填充器，
+     // 它依据给定的布局资源文件，解析并创建对应的视图层次结构，是Android中构建界面视图的重要工具。
+     * @param container 父视图容器，通常是Activity中用于承载Fragment视图的布局容器，
+     // Fragment的视图会被添加到这个容器中，以正确显示在Activity的界面上。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），
+     // 可以用于在Fragment重建（比如屏幕旋转等情况）时恢复之前的界面状态、数据等内容，保持用户体验的连贯性。
+     * @return 返回创建好的视图对象，该对象将作为Fragment的界面展示内容，添加到父视图容器中呈现给用户。
+     */
     @Nullable
     @Override
     public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
+        // 加载fragment_download_music布局文件并创建视图对象，这一步根据指定的布局资源ID（R.layout.fragment_download_music），
+        // 使用布局填充器将布局文件解析并实例化为一个视图层次结构对象。
         View view = inflater.inflate(R.layout.fragment_download_music, container, false);
+        // 注册当前Fragment到EventBus，用于接收事件（例如歌曲下载成功、已下载歌曲列表有更新等相关事件），
+        // 这样当其他地方发布了与下载相关的事件时，该Fragment能够接收到通知并做出相应的界面更新操作。
         EventBus.getDefault().register(this);
+        // 通过ButterKnife框架将视图与代码中的变量进行绑定，使得可以方便地操作布局中的视图组件，
+        // 例如通过绑定后的变量来设置RecyclerView的属性、添加点击事件监听等操作。
         unbinder = ButterKnife.bind(this, view);
+        // 创建一个空的已下载歌曲列表，后续将从本地文件等途径获取已下载歌曲的详细信息并填充到该列表中。
         mDownloadSongList = new ArrayList<>();
         return view;
     }
 
+    /**
+     * 当Fragment所在的Activity创建完成后调用，主要用于启动播放服务并绑定服务以获取相关功能，
+     // 调用展示已下载歌曲列表的方法，完成界面的初始化及与播放服务建立通信连接，为后续展示已下载歌曲列表以及播放歌曲操作做准备。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），可用于恢复之前的相关状态（如果有需要），
+     // 不过在当前代码中未体现具体的恢复逻辑，一般可以用于一些诸如之前已经获取到的部分已下载歌曲相关数据等情况的恢复。
+     */
     @Override
     public void onActivityCreated(Bundle savedInstanceState) {
         super.onActivityCreated(savedInstanceState);
-        //启动服务
+        // 创建启动播放服务的Intent对象，指定要启动的服务类为PlayerService，用于后续与播放服务的交互操作，
+        // Intent是Android中用于启动组件（如Activity、Service等）或者传递消息的重要机制，这里用于指定要启动的播放服务。
         Intent playIntent = new Intent(getActivity(), PlayerService.class);
+        // 绑定播放服务，通过传入的ServiceConnection对象（connection）监听服务连接状态，
+        // 并设置绑定模式为自动创建服务（如果服务未启动则自动启动），确保播放服务能正常运行并与Fragment建立通信连接，
+        // 这一步操作使得Fragment能够与播放服务进行双向通信，获取服务提供的功能并向服务传递相关指令（如播放歌曲等）。
         Objects.requireNonNull(getActivity()).bindService(playIntent, connection, Context.BIND_AUTO_CREATE);
+        // 调用方法展示已下载歌曲列表，包括从本地文件获取数据、设置布局管理器、创建适配器以及设置列表项点击事件监听等操作，
+        // 使得RecyclerView能够正确展示已下载歌曲的相关信息，并能响应用户的点击播放等操作。
         showSongList();
     }
 
-    private void showSongList(){
+    /**
+     * 展示已下载歌曲列表的方法，先从本地文件获取已下载歌曲数据并进行逆序排列整理，
+     // 创建已下载歌曲列表的适配器，创建线性布局管理器并设置给RecyclerView，最后将适配器设置给RecyclerView用于展示已下载歌曲记录列表，
+     // 同时为已下载歌曲列表的适配器设置列表项点击事件监听，点击时进行一系列歌曲相关信息的设置（如歌曲名称、歌手、播放地址等），
+     // 保存歌曲信息到本地，并调用播放服务的方法开始播放对应已下载歌曲，完成列表展示及点击播放功能的配置工作。
+     */
+    private void showSongList() {
+        // 调用orderList方法对从本地文件（通过DownloadUtil.getSongFromFile方法，依据指定的文件路径STORAGE_SONG_FILE获取）
+        // 获取到的已下载歌曲数据进行逆序排列整理，逆序排列可能是为了按照某种特定顺序（如时间倒序等）展示已下载歌曲，更符合用户查看习惯。
         mDownloadSongList = orderList(DownloadUtil.getSongFromFile(STORAGE_SONG_FILE));
+        // 创建已下载歌曲列表的适配器，传入当前Activity上下文和整理后的已下载歌曲列表数据，用于将数据绑定到视图上展示，
+        // 适配器负责将数据与RecyclerView的视图项进行绑定，设置每个视图项的展示样式，并处理相关交互逻辑（如点击事件）。
         mAdapter = new DownloadSongAdapter(getActivity(), mDownloadSongList);
+        // 创建线性布局管理器，设置为垂直方向排列（默认情况），用于管理RecyclerView中已下载歌曲列表的布局展示，
+        // 确定列表项是垂直排列的，方便用户上下滑动查看不同的已下载歌曲信息，符合常见的列表展示习惯。
         mManager = new LinearLayoutManager(getActivity());
+        // 将线性布局管理器设置给RecyclerView，确定其布局方式，使得音乐列表能按照设定的方式展示，
+        // 确保RecyclerView的布局效果符合预期，方便用户查看和操作列表中的歌曲信息。
         songRecycle.setLayoutManager(mManager);
+        // 将创建好的适配器设置给RecyclerView，使其能够展示已下载歌曲记录列表，
+        // 这样RecyclerView就能依据适配器提供的数据和展示逻辑，将已下载歌曲的信息展示给用户了。
         songRecycle.setAdapter(mAdapter);
 
+        // 为已下载歌曲列表的适配器设置列表项点击事件监听，点击时进行以下操作，用于实现点击播放已下载歌曲的功能。
         mAdapter.setOnItemClickListener(position -> {
+            // 获取点击位置对应的已下载歌曲信息对象，以便后续提取该歌曲的各项详细信息进行相关操作。
             DownloadSong downloadSong = mDownloadSongList.get(position);
+            // 创建一个Song对象，用于设置当前点击歌曲的相关信息，方便后续保存和播放操作，
+            // 这个Song对象可能是应用中统一用于表示歌曲信息的实体类，整合了歌曲各方面的关键属性。
             Song song = new Song();
+            // 设置歌曲的唯一标识，通常在数据库或者整个应用体系中有唯一性，用于准确区分不同歌曲。
             song.setSongId(downloadSong.getSongId());
+            // 设置歌曲的名称，用于在界面展示以及后续可能的查找、排序等操作中使用，方便用户识别歌曲。
             song.setSongName(downloadSong.getName());
+            // 设置歌曲的演唱者信息，同样有助于用户明确歌曲来源以及在界面展示等场景中提供更详细的歌曲描述。
             song.setSinger(downloadSong.getSinger());
+            // 设置歌曲是否为在线歌曲的标识为false，表示是已下载的本地歌曲，用于后续播放等操作中区分歌曲来源类型。
             song.setOnline(false);
+            // 设置歌曲的播放地址，这是实际播放歌曲时需要的关键信息，播放服务会依据这个地址来获取音频资源进行播放。
             song.setUrl(downloadSong.getUrl());
-            Log.d(TAG, "showSongList: "+song.getUrl());
+            Log.d(TAG, "showSongList: " + song.getUrl());
+            // 设置歌曲的封面图片地址（如果有的话），可用于在界面展示歌曲时显示对应的封面图片，提升视觉效果和用户体验。
             song.setImgUrl(downloadSong.getPic());
+            // 设置歌曲在列表中的位置索引，方便记录当前点击歌曲在列表中的顺序等相关操作，比如定位播放位置等。
             song.setPosition(position);
+            // 设置歌曲的时长信息，用于在界面展示歌曲时长或者进行一些与时长相关的操作（如播放进度计算等）。
             song.setDuration(downloadSong.getDuration());
+            // 设置歌曲所属的列表类型为下载类型，用于标识歌曲来源或者在应用中进行分类管理等操作，
+            // 例如在不同的播放逻辑或者统计场景下可以依据这个类型进行区分处理。
             song.setListType(Constant.LIST_TYPE_DOWNLOAD);
+            // 设置歌曲的媒体资源唯一标识（可能用于更细致地区分不同版本或者来源的媒体资源等情况）。
             song.setMediaId(downloadSong.getMediaId());
+            // 设置歌曲的下载状态为已下载，用于记录歌曲的下载情况等相关属性设置。
             song.setDownload(true);
+            // 通过FileUtil工具类将歌曲相关信息保存到本地，具体保存的方式和位置由FileUtil的实现决定，
+            // 可能是保存到本地文件或者数据库中，方便后续操作（如记录播放历史、恢复播放状态等），
+            // 确保应用能持久化用户的操作记录以及播放相关信息，提升用户体验的连贯性。
             FileUtil.saveSong(song);
 
+            // 通过获取到的与播放服务交互的Binder对象（mPlayStatusBinder）调用播放服务中的播放方法，
+            // 传入Constant.LIST_TYPE_DOWNLOAD表示播放的是已下载类型的歌曲，从而实现点击已下载歌曲列表中的歌曲后进行播放的功能。
             mPlayStatusBinder.play(Constant.LIST_TYPE_DOWNLOAD);
         });
     }
 
+    /**
+     * 订阅EventBus的事件，当接收到DownloadEvent类型的事件且事件中的下载状态表示歌曲下载成功时，
+     // 进行相应的界面更新操作，先清空已下载歌曲列表，再重新从本地文件获取已下载歌曲数据填充列表，
+     // 最后通知RecyclerView的适配器数据集已改变，触发界面刷新，展示最新的已下载歌曲列表情况，
+     // 确保界面展示与实际已下载歌曲情况保持一致，能及时反映新下载歌曲的添加情况。
+     * @param event 接收到的DownloadEvent事件对象，包含了下载相关的各种信息，如下载状态、下载歌曲信息等，
+     // 根据事件携带的具体信息，来判断是否是歌曲下载成功的情况，进而决定如何更新界面展示内容。
+     */
     @Subscribe(threadMode = ThreadMode.MAIN)
-    public void onDownloadSuccessEvent(DownloadEvent event){
+    public void onDownloadSuccessEvent(DownloadEvent event) {
-        if(event.getDownloadStatus() == Constant.TYPE_DOWNLOAD_SUCCESS){
+        if (event.getDownloadStatus() == Constant.TYPE_DOWNLOAD_SUCCESS) {
             mDownloadSongList.clear();
             mDownloadSongList.addAll(orderList(DownloadUtil.getSongFromFile(STORAGE_SONG_FILE)));
             mAdapter.notifyDataSetChanged();
         }
     }
 
+    /**
+     * 订阅EventBus的事件，当接收到SongDownloadedEvent类型的事件时，
+     * 通知RecyclerView的适配器数据集已改变，触发界面刷新，用于在已下载歌曲有其他相关更新情况（具体由SongDownloadedEvent定义）时，
+     * 使得界面能够及时展示最新的已下载歌曲状态，保证界面与实际数据的一致性，提升用户体验。
+     * @param event 接收到的SongDownloadedEvent事件对象，虽然这里没有对其内部具体携带的信息做详细处理，
+     *              但该事件可能包含了如歌曲元数据更新、本地存储相关变动等影响已下载歌曲展示的信息，
+     *              通过通知适配器更新界面来应对这些潜在的变化情况。
+     */
     @Subscribe(threadMode = ThreadMode.MAIN)
-    public void onSongDownloadedEvent(SongDownloadedEvent event){
+    public void onSongDownloadedEvent(SongDownloadedEvent event) {
         mAdapter.notifyDataSetChanged();
     }
 
+    /**
+     * 当Fragment的视图即将被销毁时调用，进行一些清理操作，如解除ButterKnife框架的绑定、注销在EventBus的注册等，
+     * 避免内存泄漏等问题，释放相关资源，确保应用的稳定运行和资源合理利用，同时也符合Android组件生命周期管理的规范要求。
+     */
     @Override
     public void onDestroyView() {
         super.onDestroyView();
+        // 调用ButterKnife框架的unbind方法，解除视图与代码中变量的绑定关系，释放相关资源，
+        // 避免因绑定关系未正确解除而导致的内存泄漏问题。
         unbinder.unbind();
+        // 注销当前Fragment在EventBus的注册，防止接收不必要的事件造成潜在的异常或者资源浪费等情况，
+        // 确保Fragment在不再需要接收事件时停止相关监听操作。
         EventBus.getDefault().unregister(this);
     }
-    private List<DownloadSong> orderList(List<DownloadSong> tempList){
+
-        List<DownloadSong> loveList=new ArrayList<>();
+    /**
+     * 对传入的已下载歌曲列表数据进行逆序排列的方法，创建一个新的空列表，
+     * 将传入列表中的元素从后往前（逆序）逐个添加到新列表中，最后返回整理后的逆序列表，
+     * 可用于按照时间倒序等需求展示已下载歌曲记录，使得最新下载的歌曲排在列表前面等展示效果，更符合用户查看习惯。
+     * @param tempList 从本地文件等获取的原始已下载歌曲列表数据，需要进行逆序排列整理，
+     *                 它包含了从本地获取到的所有已下载歌曲的信息集合，但是顺序可能不符合展示需求，需要进行调整。
+     * @return 返回逆序排列后的已下载歌曲列表数据，这个返回的列表将用于后续在界面上展示已下载歌曲，
+     *         以更合理的顺序呈现给用户，方便用户快速找到最近下载的歌曲等操作。
+     */
+    private List<DownloadSong> orderList(List<DownloadSong> tempList) {
+        List<DownloadSong> loveList = new ArrayList<>();
         loveList.clear();
-        for(int i=tempList.size()-1;i>=0;i--){
+        for (int i = tempList.size() - 1; i >= 0; i--) {
             loveList.add(tempList.get(i));
         }
         return loveList;

app/src/main/java/com/example/musicplayer/view/main/download/DownloadingFragment.java

@@ -47,123 +47,241 @@ import butterknife.Unbinder;
  *     time   : 2019/09/16
  *     desc   : 正在下载歌曲列表
  * </pre>
+ * 这个类表示正在下载歌曲列表展示的Fragment，用于展示当前正在下载的歌曲相关信息，
+ * 可以与下载服务进行交互来控制下载操作（如暂停、取消等），能响应下载相关事件以更新界面展示内容，
+ * 通过RecyclerView展示正在下载歌曲的列表，并处理列表项的点击事件（如暂停、取消下载等操作），
+ * 为用户提供管理正在下载歌曲的功能体验，是音乐播放器应用中下载功能模块的重要组成部分。
  */
-
 public class DownloadingFragment extends Fragment {
     private static final String TAG = "DownloadingFragment";
 
+    // 通过ButterKnife框架绑定的RecyclerView视图组件，用于展示正在下载歌曲的列表，
+    // 可以展示每首正在下载歌曲的相关信息（如歌曲名称、下载进度等），并支持列表项的交互操作（如点击暂停、取消下载等）。
     @BindView(R.id.songDowningRecycle)
     RecyclerView songDowningRecycle;
+    // 用于解除ButterKnife框架绑定的对象，在合适的时机（如Fragment销毁时）需要调用其unbind方法来释放相关资源，避免内存泄漏。
     Unbinder unbinder;
+    // 正在下载歌曲列表的适配器，负责将正在下载歌曲的数据绑定到RecyclerView的每个Item视图上进行展示，
+    // 并处理相关点击等交互逻辑，例如设置每首歌曲在列表中的显示样式，以及响应点击暂停、取消下载等操作。
     private DownloadingAdapter mAdapter;
+    // 用于管理RecyclerView布局的线性布局管理器，设置正在下载歌曲列表的布局方式（如垂直排列等），
+    // 决定了列表项在RecyclerView中的排列顺序和滚动方式等展示效果，方便用户上下滑动查看不同的正在下载歌曲信息。
     private LinearLayoutManager mLinearLayoutManager;
+    // 存储正在下载歌曲信息（DownloadInfo类型）的列表，用于展示以及后续的操作（如根据下载状态更新列表项等），
+    // 该列表的数据会从数据库或者通过与下载服务交互等方式获取并填充，然后传递给适配器用于展示在界面上。
     private List<DownloadInfo> mDownloadInfoList;  //下载队列
 
+    // 用于与下载服务进行交互的Binder对象，通过它可以调用下载服务中的方法，如开始下载、暂停下载、取消下载等操作，
+    // 在与服务成功连接后获取其实例，以便后续在需要控制歌曲下载时使用。
     private DownloadService.DownloadBinder mDownloadBinder;
-    //绑定下载服务
+    // 定义与下载服务的连接对象，用于监听服务的连接与断开状态，并获取服务提供的Binder对象进行交互，
+    // 是实现Fragment与下载服务通信的关键部分，保障了相关下载服务功能（如控制下载操作等）的正常调用，
+    // 确保Fragment能和下载服务协同工作，实现完整的正在下载歌曲管理相关功能逻辑。
+    // 绑定下载服务
     private ServiceConnection mDownloadConnection = new ServiceConnection() {
+        /**
+         * 当与服务成功连接时调用，获取服务提供的IBinder对象，并强转为对应的DownloadBinder类型，
+         // 这一步是为了能通过强转后的对象调用下载服务中特定的、针对DownloadBinder类型定义的方法，
+         // 例如开始下载、暂停下载等操作对应的方法，从而实现对下载过程的控制。
+         * @param componentName 连接的服务的组件名称，标识所连接的服务在系统中的唯一性，
+         // 可以通过这个名称来区分不同的服务，确保连接到正确的目标服务。
+         * @param iBinder 服务返回的IBinder对象，通过它可以和服务进行交互通信，
+         // 是实现跨组件（Fragment与Service）交互的重要媒介，通过它可以调用服务端暴露的方法。
+         */
         @Override
         public void onServiceConnected(ComponentName componentName, IBinder iBinder) {
             mDownloadBinder = (DownloadService.DownloadBinder) iBinder;
         }
 
+        /**
+         * 当与服务意外断开连接时调用，这里暂时没有具体实现逻辑，可根据需求添加相关处理，
+         // 比如重新尝试连接、提示用户等操作，例如可以弹出一个Toast提示用户下载服务异常断开，
+         // 或者自动重新发起连接请求，以增强应用在面对服务异常情况时的稳定性和用户友好性。
+         * @param componentName 断开连接的服务的组件名称，用于识别是哪个服务断开了连接，
+         // 方便根据不同服务进行针对性的异常处理（如果有多个服务连接的情况）。
+         */
         @Override
         public void onServiceDisconnected(ComponentName componentName) {
 
         }
     };
 
+    /**
+     * 创建Fragment的视图，加载对应的布局文件，获取布局中的各个视图组件，
+     // 同时注册到EventBus用于接收相关事件（如下载进度更新、下载完成等事件），
+     // 并通过ButterKnife框架将视图与代码中的变量进行绑定，为后续操作做准备。
+     * @param inflater 用于将布局文件实例化为视图对象的布局填充器，
+     // 它依据给定的布局资源文件，解析并创建对应的视图层次结构，是Android中构建界面视图的重要工具。
+     * @param container 父视图容器，通常是Activity中用于承载Fragment视图的布局容器，
+     // Fragment的视图会被添加到这个容器中，以正确显示在Activity的界面上。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），
+     // 可以用于在Fragment重建（比如屏幕旋转等情况）时恢复之前的界面状态、数据等内容，保持用户体验的连贯性。
+     * @return 返回创建好的视图对象，该对象将作为Fragment的界面展示内容，添加到父视图容器中呈现给用户。
+     */
     @Nullable
     @Override
     public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
+        // 加载fragment_download_ing布局文件并创建视图对象，这一步根据指定的布局资源ID（R.layout.fragment_download_ing），
+        // 使用布局填充器将布局文件解析并实例化为一个视图层次结构对象。
         View view = inflater.inflate(R.layout.fragment_download_ing, container, false);
+        // 注册当前Fragment到EventBus，用于接收事件（例如下载进度更新、下载完成、下载取消等相关事件），
+        // 这样当其他地方发布了与下载相关的事件时，该Fragment能够接收到通知并做出相应的界面更新操作。
         EventBus.getDefault().register(this);
+        // 通过ButterKnife框架将视图与代码中的变量进行绑定，使得可以方便地操作布局中的视图组件，
+        // 例如通过绑定后的变量来设置RecyclerView的属性、添加点击事件监听等操作。
         unbinder = ButterKnife.bind(this, view);
         return view;
     }
 
-
+    /**
+     * 当Fragment所在的Activity创建完成后调用，主要用于初始化RecyclerView相关设置、绑定下载服务，
+     // 完成界面的初始化及与下载服务建立通信连接，为后续展示正在下载歌曲列表以及控制下载操作做准备。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），可用于恢复之前的相关状态（如果有需要），
+     // 不过在当前代码中未体现具体的恢复逻辑，一般可以用于一些诸如之前已经获取到的部分下载相关数据等情况的恢复。
+     */
     @Override
     public void onActivityCreated(@Nullable Bundle savedInstanceState) {
+        // 调用方法初始化RecyclerView相关设置，包括创建数据列表、设置布局管理器、创建适配器以及设置列表项点击事件监听等操作，
+        // 使得RecyclerView能够正确展示正在下载歌曲的相关信息，并能响应用户的操作（如暂停、取消下载等）。
         initRecycler();
-        //绑定服务
+        // 创建启动下载服务的Intent对象，指定要启动的服务类为DownloadService，用于后续与下载服务的交互操作，
+        // Intent是Android中用于启动组件（如Activity、Service等）或者传递消息的重要机制，这里用于指定要启动的下载服务。
         Intent downIntent = new Intent(getActivity(), DownloadService.class);
+        // 绑定下载服务，通过传入的ServiceConnection对象（mDownloadConnection）监听服务连接状态，
+        // 并设置绑定模式为自动创建服务（如果服务未启动则自动启动），确保下载服务能正常运行并与Fragment建立通信连接，
+        // 这一步操作使得Fragment能够与下载服务进行双向通信，获取服务提供的功能并向服务传递相关指令（如开始下载、暂停下载等）。
         getActivity().bindService(downIntent, mDownloadConnection, Context.BIND_AUTO_CREATE);
         super.onActivityCreated(savedInstanceState);
     }
 
+    /**
+     * 初始化RecyclerView相关设置的方法，包括创建正在下载歌曲信息列表、从数据库获取数据填充列表、
+     // 设置RecyclerView的相关属性（如解决进度刷新闪屏问题）、创建线性布局管理器、创建适配器以及设置列表项的点击事件监听（暂停和取消下载），
+     // 全面完成RecyclerView展示正在下载歌曲列表的初始化配置工作，使得界面能够正确展示正在下载歌曲的信息，并对用户的操作做出响应。
+     */
     private void initRecycler() {
+        // 创建用于存储正在下载歌曲信息的空列表，后续将从数据库或者其他途径获取正在下载歌曲的详细信息并填充到该列表中。
         mDownloadInfoList = new LinkedList<>();
-        mDownloadInfoList.addAll(LitePal.findAll(DownloadInfo.class,true));
+        // 使用LitePal框架查询获取数据库中所有的正在下载歌曲信息（DownloadInfo类对应的表数据），并添加到正在下载歌曲信息列表中，
+        // LitePal是一个方便的Android数据库操作框架，简化了数据库查询等操作，这里用于获取存储在数据库中的正在下载歌曲记录信息。
+        mDownloadInfoList.addAll(LitePal.findAll(DownloadInfo.class, true));
+        // 设置RecyclerView的ItemAnimator为null，用于解决进度刷新时可能出现的闪屏问题，
+        // 这样在更新下载进度等操作导致界面刷新时，能有更平滑的视觉效果，提升用户体验。
         songDowningRecycle.setItemAnimator(null);  //解决进度刷新闪屏问题
+        // 创建线性布局管理器，设置为垂直方向排列（默认情况），用于管理RecyclerView中正在下载歌曲列表的布局展示，
+        // 确定列表项是垂直排列的，方便用户上下滑动查看不同的正在下载歌曲信息，符合常见的列表展示习惯。
         mLinearLayoutManager = new LinearLayoutManager(getActivity());
+        // 创建正在下载歌曲列表的适配器，传入正在下载歌曲信息列表，用于将数据绑定到视图上展示，
+        // 适配器负责将数据与RecyclerView的视图项进行绑定，设置每个视图项的展示样式，并处理相关交互逻辑（如点击事件）。
         mAdapter = new DownloadingAdapter(mDownloadInfoList);
+        // 将线性布局管理器设置给RecyclerView，确定其布局方式，使得音乐列表能按照设定的方式展示，
+        // 确保RecyclerView的布局效果符合预期，方便用户查看和操作列表中的歌曲信息。
         songDowningRecycle.setLayoutManager(mLinearLayoutManager);
+        // 将创建好的适配器设置给RecyclerView，使其能够展示正在下载歌曲记录列表，
+        // 这样RecyclerView就能依据适配器提供的数据和展示逻辑，将正在下载歌曲的信息展示给用户了。
         songDowningRecycle.setAdapter(mAdapter);
 
-        //暂停
+        // 为正在下载歌曲列表的适配器设置列表项点击事件监听，用于处理暂停下载操作，点击时进行以下操作。
         mAdapter.setOnItemClickListener(position -> {
+            // 获取点击位置对应的正在下载歌曲信息对象，以便后续根据其当前下载状态来决定执行开始下载还是暂停下载操作。
             DownloadInfo downloadInfo = mDownloadInfoList.get(position);
-            Log.d(TAG, "initRecycler: "+mDownloadInfoList.get(position).getStatus());
+            Log.d(TAG, "initRecycler: " + mDownloadInfoList.get(position).getStatus());
-            //判断是否为正在播放的歌曲
+            // 判断是否为正在播放的歌曲（这里可能通过歌曲的下载状态来判断，具体依据Constant.DOWNLOAD_PAUSED常量的定义），
-            if(downloadInfo.getStatus() == Constant.DOWNLOAD_PAUSED){
+            // 如果当前歌曲的下载状态是暂停状态，则调用下载服务的方法开始下载该歌曲。
+            if (downloadInfo.getStatus() == Constant.DOWNLOAD_PAUSED) {
                 mDownloadBinder.startDownload(downloadInfo);
-            }else {
+            } else {
-                //传入要暂停的音乐id
+                // 如果歌曲不是暂停状态（可能是正在下载等其他状态），则传入要暂停的音乐id，调用下载服务的方法暂停该歌曲的下载。
                 mDownloadBinder.pauseDownload(downloadInfo.getSongId());
             }
         });
 
-        //取消下载
+        // 为正在下载歌曲列表的适配器设置列表项点击删除（取消下载）事件监听，点击时进行以下操作，
+        // 通过弹出一个确认对话框来提示用户是否确认取消下载操作，用户确认后调用下载服务的方法取消对应歌曲的下载。
         mAdapter.setOnDeleteClickListener(position -> {
-            SpeedDialog speedDialog = new SpeedDialog(getActivity(),SpeedDialog.SELECT_TYPE);
+            // 创建一个SpeedDialog对话框实例，用于显示确认取消下载的提示信息，设置对话框的类型为选择类型（可能包含确定、取消等按钮）。
+            SpeedDialog speedDialog = new SpeedDialog(getActivity(), SpeedDialog.SELECT_TYPE);
+            // 设置对话框的标题，通过获取字符串资源来显示友好的提示标题，告知用户当前操作是取消下载。
             speedDialog.setTitle(getString(R.string.download_cancel))
-                    .setMessage(getString(R.string.download_cancel_message))
+                    // 设置对话框的详细提示信息，同样通过获取字符串资源来显示更详细的提示内容，让用户明确取消下载的后果等信息。
-                    .setSureText(getString(R.string.download_sure))
+                   .setMessage(getString(R.string.download_cancel_message))
-                    .setSureClickListener(dialog -> {
+                    // 设置对话框中确认按钮的文本内容，使用字符串资源来设置一个友好的确认按钮文本，如“确定”等。
+                   .setSureText(getString(R.string.download_sure))
+                    // 设置对话框中确认按钮的点击事件监听，当用户点击确认按钮时，调用下载服务的方法取消对应位置歌曲的下载，
+                    // 传入要取消下载的歌曲信息对象（从正在下载歌曲信息列表中获取对应位置的歌曲信息）。
+                   .setSureClickListener(dialog -> {
                         mDownloadBinder.cancelDownload(mDownloadInfoList.get(position));
                     })
-            .show();
+                    // 显示对话框，将其展示给用户，等待用户进行操作（确认或取消），以决定是否取消对应歌曲的下载。
+                   .show();
         });
 
     }
 
+    /**
+     * 订阅EventBus的事件，当接收到DownloadEvent类型的事件时，根据事件中携带的下载状态信息，
+     * 进行相应的界面更新操作，如更新下载进度、刷新列表显示、处理下载成功或取消等情况，
+     * 实现根据下载过程中的不同状态变化及时更新界面展示内容的功能，保证用户看到的界面与实际下载情况一致。
+     * @param event 接收到的DownloadEvent事件对象，包含了下载相关的各种信息，如下载状态、下载歌曲信息等，
+     *              根据事件携带的具体信息，来决定如何更新界面展示内容，例如如果是下载进度更新，就需要更新对应歌曲的进度条显示等。
+     */
     @Subscribe(threadMode = ThreadMode.MAIN)
     public void onDownloadingMessage(DownloadEvent event) {
         int status = event.getDownloadStatus();
         if (status == Constant.TYPE_DOWNLOADING || status == Constant.TYPE_DOWNLOAD_PAUSED) {//进度条更新
             DownloadInfo downloadInfo = event.getDownloadInfo();
+            // 先从正在下载歌曲信息列表中移除对应位置的歌曲信息，
             mDownloadInfoList.remove(downloadInfo.getPosition());
-            mDownloadInfoList.add(downloadInfo.getPosition(),downloadInfo);
+            // 再将更新后的歌曲信息添加回原来的位置，这样可以确保列表中对应歌曲的信息是最新的，
+            mDownloadInfoList.add(downloadInfo.getPosition(), downloadInfo);
+            // 通知RecyclerView的适配器对应位置的列表项数据已改变，触发界面更新，使得下载进度条等信息能及时刷新显示。
             mAdapter.notifyItemChanged(downloadInfo.getPosition());
-        }else if(status == Constant.TYPE_DOWNLOAD_SUCCESS){//歌曲下载成功
+        } else if (status == Constant.TYPE_DOWNLOAD_SUCCESS) {//歌曲下载成功
+            // 调用方法重新从数据库中读取需要下载的歌曲信息，更新正在下载歌曲信息列表，
+            // 因为下载成功后可能列表中的数据状态发生了变化（比如该歌曲不再处于正在下载状态了），需要重新获取最新数据。
             resetDownloadInfoList();
+            // 通知RecyclerView的适配器数据集已改变，触发整个RecyclerView界面刷新，展示最新的正在下载歌曲列表情况，
+            // 例如将已下载成功的歌曲从正在下载列表中移除等，保持界面展示与实际数据的一致性。
             mAdapter.notifyDataSetChanged();
-        }else if(status == Constant.TYPE_DOWNLOAD_CANCELED){//下载取消
+        } else if (status == Constant.TYPE_DOWNLOAD_CANCELED) {//下载取消
+            // 同样调用方法重新从数据库中读取需要下载的歌曲信息，更新正在下载歌曲信息列表，
+            // 下载取消后列表中的数据也需要更新，去除已取消下载的歌曲相关信息，获取最新的正在下载歌曲情况。
             resetDownloadInfoList();
+            // 通知RecyclerView的适配器数据集已改变，触发界面刷新，使得界面展示能及时反映下载取消后的列表变化情况，
+            // 让用户看到准确的正在下载歌曲状态。
             mAdapter.notifyDataSetChanged();
-        }else if(status == Constant.TYPE_DOWNLOAD_ADD){//添加了正在下载歌曲
+        } else if (status == Constant.TYPE_DOWNLOAD_ADD) {//添加了正在下载歌曲
+            // 当有新的歌曲添加到正在下载队列时，调用此方法重新从数据库中读取正在下载歌曲信息，
+            // 这样可以获取到包含新添加歌曲信息的最新列表数据，用于更新界面展示。
             resetDownloadInfoList();
         }
     }
 
-
+    // 重新从数据库中读取需要下载的歌曲
-    //重新从数据库中读取需要下载的歌曲
+    private void resetDownloadInfoList() {
-    private void resetDownloadInfoList(){
+        // 先清空正在下载歌曲信息列表，准备重新填充最新的数据。
         mDownloadInfoList.clear();
-        List<DownloadInfo> temp = LitePal.findAll(DownloadInfo.class,true);
+        // 使用LitePal框架查询获取数据库中所有的正在下载歌曲信息（DownloadInfo类对应的表数据），
-        if(temp.size()!=0){
+        // 如果查询到有相关数据，就将其添加到正在下载歌曲信息列表中，以更新列表内容。
+        List<DownloadInfo> temp = LitePal.findAll(DownloadInfo.class, true);
+        if (temp.size()!= 0) {
             mDownloadInfoList.addAll(temp);
         }
 
     }
 
-
+    /**
-
+     * 当Fragment的视图即将被销毁时调用，进行一些清理操作，如注销在EventBus的注册、解除ButterKnife框架的绑定等，
+     * 避免内存泄漏等问题，释放相关资源，确保应用的稳定运行和资源合理利用，同时也符合Android组件生命周期管理的规范要求。
+     */
     @Override
     public void onDestroyView() {
         super.onDestroyView();
+        // 注销当前Fragment在EventBus的注册，防止接收不必要的事件造成潜在的异常或者资源浪费等情况，
+        // 确保Fragment在不再需要接收事件时停止相关监听操作。
         EventBus.getDefault().unregister(this);
+        // 调用ButterKnife框架的unbind方法，解除视图与代码中变量的绑定关系，释放相关资源，
+        // 避免因绑定关系未正确解除而导致的内存泄漏问题。
         unbinder.unbind();
     }
 }

app/src/main/java/com/example/musicplayer/view/main/history/HistoryFragment.java

@@ -36,101 +36,257 @@ import java.util.List;
 
 /**
  * Created by 残渊 on 2018/12/2.
+ * 这个类表示历史播放音乐展示的Fragment，用于展示用户之前播放过的音乐记录列表，
+ * 是音乐播放器应用中负责呈现历史播放相关界面及交互逻辑的关键部分，
+ * 它能与播放服务进行交互获取历史播放数据、响应相关事件以更新界面展示、通过RecyclerView来展示历史播放歌曲列表，
+ * 并处理列表项点击等交互操作，为用户提供查看和再次播放历史音乐的功能体验。
  */
-
 public class HistoryFragment extends Fragment {
-    private static final String TAG="HistoryFragment";
+    private static final String TAG = "HistoryFragment";
 
+    // 用于展示历史播放音乐列表的RecyclerView组件，通过设置适配器等展示历史播放歌曲的相关信息，
+    // 如歌曲名称、歌手等，同时支持列表项的点击等交互操作，方便用户操作历史播放记录中的歌曲。
     private RecyclerView mRecycler;
+    // 用于返回上一界面的ImageView组件，通常点击该图标可实现返回功能，遵循常见的界面导航逻辑，
+    // 使得用户可以方便地回到之前浏览的页面，增强应用的操作便利性。
     private ImageView mBackIv;
+    // 用于管理RecyclerView布局的线性布局管理器，设置历史播放音乐列表的布局方式（如垂直排列等），
+    // 决定了列表项在RecyclerView中的排列顺序和滚动方式等展示效果，方便用户上下滑动查看不同的历史播放歌曲记录。
     private LinearLayoutManager mManager;
+    // 历史播放音乐列表的适配器，负责将历史播放歌曲数据绑定到RecyclerView的每个Item视图上进行展示，
+    // 例如设置每首歌曲在列表中的显示样式，同时处理相关点击等交互逻辑，如响应点击某首歌曲时的播放等操作。
     private HistoryAdapter mAdapter;
+    // 用于展示包含历史播放音乐列表的线性布局，可能用于整体布局调整或者和其他相关组件组合展示等用途，
+    // 比如可以在该线性布局内添加一些装饰性元素或者其他与列表相关的附属信息展示等。
     private LinearLayout mSongListLinear;
+    // 用于在历史播放音乐列表为空时展示提示信息等相关布局的RelativeLayout组件，提示用户当前无历史播放记录，
+    // 例如可以在该布局中显示一段友好的提示文字，告知用户暂无历史播放歌曲可供查看，提升用户体验。
     private RelativeLayout mEmptyRelative;
+    // 存储历史播放歌曲数据（HistorySong类型）的列表，用于展示以及后续的操作（如点击播放等），
+    // 该列表会从数据库或者其他存储方式获取历史播放歌曲的详细信息并填充，然后传递给适配器用于展示在界面上。
     private List<HistorySong> mHistoryList;
+    // 用于显示标题的TextView组件，从代码中看设置为“最近播放”，用于标识该界面展示的是历史播放相关内容，
+    // 让用户一眼能明确当前界面的功能和所展示数据的性质，符合界面设计的友好性原则。
     private TextView mTitleTv;
 
+    // 用于与播放服务进行交互的Binder对象，通过它可以调用播放服务中的方法，如获取历史播放列表、控制播放等操作，
+    // 在与服务成功连接后获取其实例，以便后续在需要与播放服务交互时（比如播放历史歌曲、获取更多播放历史相关信息等操作）使用。
     private PlayerService.PlayStatusBinder mPlayStatusBinder;
+
+    // 定义与播放服务的连接对象，用于监听服务的连接与断开状态，并获取服务提供的Binder对象进行交互，
+    // 是实现Fragment与播放服务通信的关键部分，保障了相关播放服务功能（如获取历史播放列表、执行播放操作等）的正常调用，
+    // 确保Fragment能和播放服务协同工作，实现完整的历史播放相关功能逻辑。
     private ServiceConnection connection = new ServiceConnection() {
+        /**
+         * 当与服务成功连接时调用，获取服务提供的IBinder对象，并强转为对应的PlayStatusBinder类型，
+         // 这一步是为了能通过强转后的对象调用播放服务中特定的、针对PlayStatusBinder类型定义的方法，
+         // 同时调用播放服务中的获取历史播放列表方法（mPlayStatusBinder.getHistoryList()），
+         // 用于获取用户之前的播放记录信息，以便后续展示在界面上，实现数据的获取和准备展示的操作流程。
+         * @param name 连接的服务的组件名称，标识所连接的服务在系统中的唯一性，
+         // 可以通过这个名称来区分不同的服务，确保连接到正确的目标服务。
+         * @param service 服务返回的IBinder对象，通过它可以和服务进行交互通信，
+         // 是实现跨组件（Fragment与Service）交互的重要媒介，通过它可以调用服务端暴露的方法。
+         */
         @Override
         public void onServiceConnected(ComponentName name, IBinder service) {
             mPlayStatusBinder = (PlayerService.PlayStatusBinder) service;
             mPlayStatusBinder.getHistoryList();
         }
 
+        /**
+         * 当与服务意外断开连接时调用，这里暂时没有具体实现逻辑，可根据需求添加相关处理，
+         // 比如重新尝试连接、提示用户等操作，例如可以弹出一个Toast提示用户播放服务异常断开，
+         // 或者自动重新发起连接请求，以增强应用在面对服务异常情况时的稳定性和用户友好性。
+         * @param name 断开连接的服务的组件名称，用于识别是哪个服务断开了连接，
+         // 方便根据不同服务进行针对性的异常处理（如果有多个服务连接的情况）。
+         */
         @Override
         public void onServiceDisconnected(ComponentName name) {
 
         }
     };
 
+    /**
+     * 创建Fragment的视图，加载对应的布局文件，获取布局中的各个视图组件，
+     // 这是Fragment展示界面的基础操作，通过加载布局文件将定义好的界面结构实例化为视图对象，
+     // 同时注册到EventBus用于接收相关事件（如历史播放列表更新等事件），为后续操作做准备，
+     // 使得Fragment能够响应外部发布的相关事件，及时更新界面展示内容。
+     * @param inflater 用于将布局文件实例化为视图对象的布局填充器，
+     // 它依据给定的布局资源文件，解析并创建对应的视图层次结构，是Android中构建界面视图的重要工具。
+     * @param container 父视图容器，通常是Activity中用于承载Fragment视图的布局容器，
+     // Fragment的视图会被添加到这个容器中，以正确显示在Activity的界面上。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），
+     // 可以用于在Fragment重建（比如屏幕旋转等情况）时恢复之前的界面状态、数据等内容，保持用户体验的连贯性。
+     * @return 返回创建好的视图对象，该对象将作为Fragment的界面展示内容，添加到父视图容器中呈现给用户。
+     */
     @Override
     public View onCreateView(LayoutInflater inflater, ViewGroup container,
                              Bundle savedInstanceState) {
+        // 加载fragment_love布局文件并创建视图对象（这里布局文件名可能不太准确对应功能，也许是复用的布局或者后续需要修改为更合适的名字），
+        // 这一步根据指定的布局资源ID（R.layout.fragment_love），使用布局填充器将布局文件解析并实例化为一个视图层次结构对象。
         View view = inflater.inflate(R.layout.fragment_love, container, false);
+        // 注册当前Fragment到EventBus，用于接收事件（例如历史播放相关的更新事件等，用于更新界面等操作），
+        // 这样当其他地方发布了与历史播放相关的事件时，该Fragment能够接收到通知并做出相应的界面更新操作。
         EventBus.getDefault().register(this);
+        // 从加载的布局中找到对应的用于展示历史播放音乐列表的RecyclerView组件，
+        // 通过视图对象的findViewById方法，依据布局文件中定义的组件ID，获取对应的视图实例，以便后续对其进行操作。
         mRecycler = view.findViewById(R.id.recycler_love_songs);
+        // 从加载的布局中找到对应的返回上一界面的ImageView组件，同样是通过ID查找视图实例，方便后续设置点击事件等操作。
         mBackIv = view.findViewById(R.id.iv_back);
+        // 从加载的布局中找到对应的在列表为空时展示提示信息的RelativeLayout组件，获取该布局实例用于后续控制其显示隐藏等操作。
         mEmptyRelative = view.findViewById(R.id.relative_empty);
+        // 从加载的布局中找到对应的包含历史播放音乐列表的线性布局组件，以备后续对整个列表区域进行布局相关操作（如添加子视图、设置背景等）。
         mSongListLinear = view.findViewById(R.id.linear_song_list);
+        // 从加载的布局中找到对应的用于显示标题的TextView组件，获取该实例用于设置标题文本等操作。
         mTitleTv = view.findViewById(R.id.tv_title);
+        // 设置标题TextView的文本内容为“最近播放”，明确界面展示的是历史播放记录相关内容，
+        // 让用户能直观地了解当前界面所呈现信息的性质，符合界面设计的清晰易懂原则。
         mTitleTv.setText("最近播放");
         return view;
     }
 
+    /**
+     * 当Fragment所在的Activity创建完成后调用，主要用于启动播放服务并绑定服务以获取相关功能，
+     // 通过绑定服务建立与播放服务的通信连接，以便后续调用服务中的方法获取历史播放数据等操作，
+     // 调用展示历史播放歌曲列表的方法以及设置各种点击事件的监听逻辑，完成界面的初始化及交互功能配置，
+     // 使得界面能够正确展示历史播放歌曲列表，并对用户的操作（如点击歌曲、点击返回按钮等）做出响应。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），可用于恢复之前的相关状态（如果有需要），
+     // 例如之前已经获取到的部分历史播放数据等情况，不过在当前代码中未体现具体的恢复逻辑。
+     */
     @Override
     public void onActivityCreated(Bundle savedInstanceState) {
         super.onActivityCreated(savedInstanceState);
-        //启动服务
+        // 创建启动播放服务的Intent对象，指定要启动的服务类为PlayerService，用于后续与播放服务的交互操作，
+        // Intent是Android中用于启动组件（如Activity、Service等）或者传递消息的重要机制，这里用于指定要启动的播放服务。
         Intent playIntent = new Intent(getActivity(), PlayerService.class);
+        // 绑定播放服务，通过传入的ServiceConnection对象监听服务连接状态，
+        // 并设置绑定模式为自动创建服务（如果服务未启动则自动启动），确保播放服务能正常运行并与Fragment建立通信连接，
+        // 这一步操作使得Fragment能够与播放服务进行双向通信，获取服务提供的功能并向服务传递相关指令（如获取历史播放列表、执行播放操作等）。
         getActivity().bindService(playIntent, connection, Context.BIND_AUTO_CREATE);
+        // 调用方法展示历史播放歌曲列表，包括从数据库获取数据、设置适配器、布局管理器等操作，使得列表能正确展示，
+        // 完成RecyclerView展示历史播放歌曲的相关配置工作，让用户能够看到历史播放记录的具体内容。
         showSongList();
+        // 调用方法设置各种点击事件的监听逻辑，如历史播放歌曲列表项点击、返回上一界面点击等操作，实现交互功能，
+        // 通过设置点击事件监听，使得用户在界面上的操作能够触发相应的业务逻辑，如播放歌曲、返回上一界面等。
         onClick();
     }
+
+    /**
+     * 当Fragment被销毁时调用，进行一些清理操作，如解除与播放服务的绑定、注销在EventBus的注册等，
+     // 解除服务绑定可以避免因未正确关闭连接导致的资源泄漏问题，注销EventBus注册防止接收不必要的事件造成的潜在异常，
+     // 避免内存泄漏等问题，释放相关资源，确保应用的稳定运行和资源合理利用，提高应用的性能和稳定性。
+     */
     @Override
-    public void onDestroy(){
+    public void onDestroy() {
         super.onDestroy();
         getActivity().unbindService(connection);
         EventBus.getDefault().unregister(this);
     }
 
-    @Subscribe(threadMode = ThreadMode.MAIN )
+    /**
-    public void onMessageEvent(SongHistoryEvent event){
+     * 订阅EventBus的事件，当接收到SongHistoryEvent类型的事件时，
+     // SongHistoryEvent可能是一个自定义的事件类，用于传递与历史播放歌曲相关的变化信息（如新增、删除记录等情况），
+     // 通知历史播放音乐列表适配器数据集已改变，触发RecyclerView更新界面展示内容，
+     // 通过调用适配器的notifyDataSetChanged方法，告知RecyclerView数据发生了变化，需要重新绘制界面来展示最新的数据状态，
+     // 实现历史播放列表相关数据变化时界面能及时更新展示的功能，保证用户看到的界面内容始终与实际数据一致。
+     * @param event 接收到的SongHistoryEvent事件对象，包含了历史播放歌曲相关的变化信息（如新增、删除记录等情况），
+     // 根据事件携带的具体信息，来决定如何更新界面展示内容，例如如果是新增记录，就需要在列表中添加对应的展示项等。
+     */
+    @Subscribe(threadMode = ThreadMode.MAIN)
+    public void onMessageEvent(SongHistoryEvent event) {
         mAdapter.notifyDataSetChanged();
     }
 
+    /**
+     * 展示历史播放歌曲列表的方法，先调用orderList方法对从数据库获取的历史播放歌曲数据进行逆序排列整理，
+     // 逆序排列可能是为了按照时间倒序等需求展示历史播放记录，使得最新播放的歌曲排在列表前面等展示效果，更符合用户查看习惯，
+     // 创建历史播放音乐列表的适配器，创建线性布局管理器并设置给RecyclerView，最后将适配器设置给RecyclerView用于展示历史播放记录列表，
+     // 完成列表展示的相关配置工作，使得RecyclerView能够正确展示历史播放歌曲的详细信息，方便用户查看和操作。
+     */
     private void showSongList() {
+        // 调用orderList方法对从数据库获取的所有历史播放歌曲数据（通过LitePal框架查询HistorySong类对应的表数据）进行逆序排列整理，
+        // LitePal是一个方便的Android数据库操作框架，简化了数据库查询等操作，这里用于获取存储在数据库中的历史播放歌曲记录信息。
         mHistoryList = orderList(LitePal.findAll(HistorySong.class));
+        // 创建历史播放音乐列表的适配器，传入当前Activity上下文和整理后的历史播放歌曲列表数据，用于将数据绑定到视图上展示，
+        // 适配器负责将数据与RecyclerView的视图项进行绑定，设置每个视图项的展示样式，并处理相关交互逻辑（如点击事件）。
         mAdapter = new HistoryAdapter(getActivity(), mHistoryList);
+        // 创建线性布局管理器，设置为垂直方向排列（默认情况），用于管理RecyclerView中历史播放音乐列表的布局展示，
+        // 确定列表项是垂直排列的，方便用户上下滑动查看不同的历史播放歌曲记录，符合常见的列表展示习惯。
         mManager = new LinearLayoutManager(getActivity());
+        // 将线性布局管理器设置给RecyclerView，确定其布局方式，使得音乐列表能按照设定的方式展示，
+        // 确保RecyclerView的布局效果符合预期，方便用户查看和操作列表中的歌曲信息。
         mRecycler.setLayoutManager(mManager);
+        // 将创建好的适配器设置给RecyclerView，使其能够展示历史播放记录列表，
+        // 这样RecyclerView就能依据适配器提供的数据和展示逻辑，将历史播放歌曲信息展示给用户了。
         mRecycler.setAdapter(mAdapter);
     }
 
+    /**
+     * 设置各种点击事件的监听逻辑的方法，包括历史播放歌曲列表项点击事件和返回上一界面的点击事件。
+     * 通过设置这些点击事件监听，实现了用户与界面的交互功能，使得用户的操作能够触发相应的业务逻辑，
+     * 点击历史播放歌曲列表项时，进行一系列歌曲相关信息的设置（如歌曲名称、歌手、播放地址等），
+     * 保存歌曲信息到本地，并调用播放服务的方法开始播放对应历史播放歌曲，实现用户再次播放历史歌曲的功能需求；
+     * 点击返回图标时，通过Fragment管理器返回上一界面，遵循常见的界面导航逻辑，方便用户在界面间进行切换操作。
+     */
     private void onClick() {
+        // 为历史播放音乐列表的适配器设置列表项点击事件监听，点击时进行以下操作，
+        // 这里定义了用户点击历史播放歌曲列表项时的具体响应逻辑，实现了播放历史歌曲的核心功能。
         mAdapter.setOnItemClickListener(position -> {
+            // 获取点击位置对应的历史播放歌曲数据对象，以便后续提取该歌曲的各项详细信息进行相关操作。
             HistorySong history = mHistoryList.get(position);
+            // 创建一个Song对象，用于设置当前点击歌曲的相关信息，方便后续保存和播放操作，
+            // 这个Song对象可能是应用中统一用于表示歌曲信息的实体类，整合了歌曲各方面的关键属性。
             Song song = new Song();
+            // 设置歌曲的唯一标识，通常在数据库或者整个应用体系中有唯一性，用于准确区分不同歌曲。
             song.setSongId(history.getSongId());
+            // 设置歌曲的名称，用于在界面展示以及后续可能的查找、排序等操作中使用，方便用户识别歌曲。
             song.setSongName(history.getName());
+            // 设置歌曲的演唱者信息，同样有助于用户明确歌曲来源以及在界面展示等场景中提供更详细的歌曲描述。
             song.setSinger(history.getSinger());
+            // 设置歌曲是否为在线歌曲的标识，根据历史播放记录中对应歌曲的该属性进行赋值，
+            // 后续可能根据这个标识来决定播放时的获取方式（如在线播放还是本地播放等）。
             song.setOnline(history.isOnline());
+            // 设置歌曲的播放地址，这是实际播放歌曲时需要的关键信息，播放服务会依据这个地址来获取音频资源进行播放。
             song.setUrl(history.getUrl());
+            // 设置歌曲的封面图片地址（如果有的话），可用于在界面展示歌曲时显示对应的封面图片，提升视觉效果和用户体验。
             song.setImgUrl(history.getPic());
+            // 设置歌曲在列表中的位置索引，方便记录当前点击歌曲在列表中的顺序等相关操作，比如定位播放位置等。
             song.setPosition(position);
+            // 设置歌曲的时长信息，用于在界面展示歌曲时长或者进行一些与时长相关的操作（如播放进度计算等）。
             song.setDuration(history.getDuration());
+            // 设置歌曲的媒体资源唯一标识（可能用于更细致地区分不同版本或者来源的媒体资源等情况）。
             song.setMediaId(history.getMediaId());
+            // 设置歌曲所属的列表类型为历史播放类型，用于标识歌曲来源或者在应用中进行分类管理等操作，
+            // 例如在不同的播放逻辑或者统计场景下可以依据这个类型进行区分处理。
             song.setListType(Constant.LIST_TYPE_HISTORY);
+            // 通过FileUtil工具类将歌曲相关信息保存到本地，具体保存的方式和位置由FileUtil的实现决定，
+            // 可能是保存到本地文件或者数据库中，方便后续操作（如记录播放历史、恢复播放状态等），
+            // 确保应用能持久化用户的操作记录以及播放相关信息，提升用户体验的连贯性。
             FileUtil.saveSong(song);
 
+            // 通过获取到的与播放服务交互的Binder对象（mPlayStatusBinder）调用播放服务中的播放方法，
+            // 传入Constant.LIST_TYPE_HISTORY表示播放的是历史播放类型的歌曲，从而实现点击历史播放列表中的歌曲后进行播放的功能，
+            // 这一步是触发实际播放操作的关键，通过与播放服务的交互，让用户能够再次收听之前播放过的歌曲。
             mPlayStatusBinder.play(Constant.LIST_TYPE_HISTORY);
         });
+        // 为返回上一界面的ImageView设置点击事件监听，点击时通过Fragment管理器弹出当前Fragment所在的栈，返回上一界面，
+        // 遵循常见的界面导航逻辑，方便用户在界面间进行切换操作，使得用户可以按照自己的浏览路径方便地回退，提升应用的易用性。
         mBackIv.setOnClickListener(v -> getActivity().getSupportFragmentManager().popBackStack());
     }
-    private List<HistorySong> orderList(List<HistorySong> tempList){
+
-        List<HistorySong> historyList=new ArrayList<>();
+    /**
+     * 对传入的历史播放歌曲列表数据进行逆序排列的方法，创建一个新的空列表，
+     * 将传入列表中的元素从后往前（逆序）逐个添加到新列表中，最后返回整理后的逆序列表，
+     * 可用于按照时间倒序等需求展示历史播放记录，使得最新播放的歌曲排在列表前面等展示效果，更符合用户查看习惯。
+     * @param tempList 从数据库获取的原始历史播放歌曲列表数据，需要进行逆序排列整理，
+     *                 它包含了从数据库查询出来的所有历史播放歌曲的信息集合，但是顺序可能不符合展示需求，需要进行调整。
+     * @return 返回逆序排列后的历史播放歌曲列表数据，这个返回的列表将用于后续在界面上展示历史播放歌曲，
+     *         以更合理的顺序呈现给用户，方便用户快速找到最近播放的歌曲等操作。
+     */
+    private List<HistorySong> orderList(List<HistorySong> tempList) {
+        List<HistorySong> historyList = new ArrayList<>();
         historyList.clear();
-        for(int i=tempList.size()-1;i>=0;i--){
+        for (int i = tempList.size() - 1; i >= 0; i--) {
             historyList.add(tempList.get(i));
         }
         return historyList;

app/src/main/java/com/example/musicplayer/view/main/local/LocalFragment.java

@@ -36,41 +36,77 @@ import java.util.Objects;
 
 import butterknife.BindView;
 
-
+/**
+ * 这个类表示本地音乐展示的Fragment，用于展示本地存储的音乐列表，
+ * 遵循MVP模式，实现了ILocalContract.View接口定义的视图相关操作规范，
+ * 同时继承自BaseMvpFragment，具备与Presenter交互、处理服务连接、响应相关事件以及管理本地音乐列表展示等功能，
+ * 是音乐播放器中负责呈现本地音乐相关界面及交互逻辑的重要部分。
+ */
 public class LocalFragment extends BaseMvpFragment<LocalPresenter> implements ILocalContract.View {
     private static final String TAG = "LocalFragment";
 
+    // 通过ButterKnife框架绑定的RecyclerView视图组件，用于展示本地音乐列表，支持列表项的展示和交互操作，
+    // 例如通过设置适配器展示每首本地音乐的相关信息，并响应列表项的点击等事件。
     @BindView(R.id.normalView)
     RecyclerView mRecycler;
+    // 通过ButterKnife框架绑定的ImageView视图组件，可能用于触发查找本地音乐等相关操作（从代码逻辑推测），
+    // 比如点击后可以重新扫描本地存储设备以获取最新的本地音乐文件信息等。
     @BindView(R.id.iv_find_local_song)
     ImageView mFindLocalMusicIv;
+    // 通过ButterKnife框架绑定的ImageView视图组件，通常用于点击返回上一界面等操作，提供返回功能，
+    // 方便用户在该界面导航回之前浏览的页面，遵循常见的界面交互逻辑。
     @BindView(R.id.iv_back)
     ImageView mBackIv;
+    // 通过ButterKnife框架绑定的RelativeLayout视图组件，可能用于在本地音乐列表为空时展示提示信息等相关布局展示，
+    // 例如显示一个友好的提示文本告知用户当前没有本地音乐可供播放等情况。
     @BindView(R.id.linear_empty)
     RelativeLayout mEmptyViewLinear;
 
-
+    // 存储本地音乐数据（LocalSong类型）的列表，用于展示以及后续的操作（如点击播放等），
+    // 该列表会从数据库或者本地文件扫描等方式获取本地音乐信息并填充，然后传递给适配器用于展示在界面上。
     private List<LocalSong> mLocalSongsList;
+    // 本地音乐的Presenter对象，用于处理业务逻辑，如获取本地音乐数据、与数据层交互等，遵循MVP模式，
+    // 它负责处理和协调视图层（本Fragment）与数据层之间的通信和操作，使得界面展示与数据获取等逻辑分离。
     private LocalPresenter mPresenter;
+    // 本地音乐列表的适配器，负责将本地音乐数据绑定到RecyclerView的每个Item视图上进行展示，
+    // 并处理相关点击等交互逻辑，例如设置每首音乐在列表中的显示样式，以及响应点击某首音乐时的播放等操作。
     private SongAdapter songAdapter;
+    // 用于管理RecyclerView布局的线性布局管理器，设置列表的布局方式（如垂直排列等），
+    // 决定了本地音乐列表在RecyclerView中的排列顺序和滚动方式等展示效果。
     private LinearLayoutManager layoutManager;
-    //在onServiceConnected中获取PlayStatusBinder的实例，从而调用服务里面的方法
+    // 用于与播放服务进行交互的Binder对象，通过它可以调用播放服务中的方法，如控制本地音乐播放、暂停、切换等操作，
+    // 在onServiceConnected方法中获取其实例，以便后续在用户操作音乐播放相关功能时使用。
     private PlayerService.PlayStatusBinder mPlayStatusBinder;
 
-
+    // 定义与播放服务的连接对象，用于监听服务的连接与断开状态，并获取服务提供的Binder对象进行交互，
+    // 是实现Fragment与播放服务通信的关键部分，确保播放相关操作能正确执行。
     private ServiceConnection connection = new ServiceConnection() {
+        /**
+         * 当与服务成功连接时调用，获取服务提供的IBinder对象，并强转为对应的PlayStatusBinder类型，
+         * 以便后续调用播放服务中的方法进行播放控制等操作，例如调用播放、暂停、下一首等方法来实现音乐播放功能。
+         * @param name 连接的服务的组件名称，标识所连接的服务在系统中的唯一性。
+         * @param service 服务返回的IBinder对象，通过它可以和服务进行交互通信。
+         */
         @Override
         public void onServiceConnected(ComponentName name, IBinder service) {
             mPlayStatusBinder = (PlayerService.PlayStatusBinder) service;
         }
 
+        /**
+         * 当与服务意外断开连接时调用，这里暂时没有具体实现逻辑，可根据需求添加相关处理，
+         * 比如重新尝试连接、提示用户等操作，例如可以弹出一个Toast提示用户播放服务异常断开，或者自动重新发起连接请求。
+         * @param name 断开连接的服务的组件名称，用于识别是哪个服务断开了连接。
+         */
         @Override
         public void onServiceDisconnected(ComponentName name) {
 
         }
     };
 
-
+    /**
+     * 当Fragment被销毁时调用，进行一些清理操作，如解除与播放服务的绑定、注销在EventBus的注册等，
+     * 避免内存泄漏等问题，释放相关资源，确保应用的稳定性和资源的合理利用。
+     */
     @Override
     public void onDestroy() {
         super.onDestroy();
@@ -78,47 +114,92 @@ public class LocalFragment extends BaseMvpFragment<LocalPresenter> implements IL
         EventBus.getDefault().unregister(this);
     }
 
+    /**
+     * 获取与当前Fragment关联的本地音乐Presenter对象，创建一个LocalPresenter实例并返回，
+     * 以符合MVP模式中视图与Presenter的交互要求，确保Presenter能处理相关业务逻辑并与视图进行通信，
+     * 使得Fragment专注于界面展示，而业务逻辑处理交给Presenter来完成。
+     * @return 返回本地音乐Presenter对象，即创建的LocalPresenter实例，用于后续与数据层交互等操作。
+     */
     @Override
     protected LocalPresenter getPresenter() {
         mPresenter = new LocalPresenter();
         return mPresenter;
     }
 
+    /**
+     * 初始化视图相关操作的方法，先调用父类的initView方法（可能有一些基础的视图初始化逻辑），
+     * 然后注册到EventBus用于接收事件，调用注册和绑定服务的方法以及初始化本地音乐RecyclerView的相关设置，
+     * 完成该Fragment界面相关的初始化准备工作，为后续展示音乐列表和响应交互操作做铺垫。
+     */
     @Override
     public void initView() {
         super.initView();
+        // 注册当前Fragment到EventBus，用于接收事件（例如本地音乐相关的更新事件等，用于更新界面等操作），
+        // 这样当有相关事件发布时，该Fragment可以及时响应并更新界面显示内容。
         EventBus.getDefault().register(this);
+        // 调用方法注册和绑定播放服务，用于后续与播放服务的交互操作，确保能正确控制音乐播放。
         registerAndBindReceive();
+        // 调用方法初始化本地音乐RecyclerView的相关设置，如设置布局管理器、加载本地音乐数据、设置适配器等操作，
+        // 使得RecyclerView能正确展示本地音乐列表信息。
         initLocalRecycler();
 
     }
 
+    /**
+     * 订阅EventBus的事件，当接收到SongLocalEvent类型的事件时，
+     * 通知本地音乐列表适配器数据集已改变，触发RecyclerView更新界面展示内容，
+     * 如果存在正在播放的歌曲（通过FileUtil.getSong获取），则滚动RecyclerView到对应歌曲的位置（有一定偏移量），
+     * 实现播放歌曲变化时列表相应更新展示的功能，保证界面展示与实际播放歌曲的同步性。
+     * @param event 接收到的SongLocalEvent事件对象，可能包含了本地歌曲相关的变化信息（如新增、播放位置变化等情况），
+     *              根据事件携带的信息来决定如何更新界面展示。
+     */
     @Subscribe(threadMode = ThreadMode.MAIN)
-    public void onMessageEvent(SongLocalEvent event){
+    public void onMessageEvent(SongLocalEvent event) {
         songAdapter.notifyDataSetChanged();
-        if (FileUtil.getSong() != null) {
+        if (FileUtil.getSong()!= null) {
             layoutManager.scrollToPositionWithOffset(FileUtil.getSong().getPosition() + 4, mRecycler.getHeight());
         }
     }
 
-
+    /**
+     * 当Fragment所在的Activity创建完成后调用，主要用于调用设置各种点击事件的监听逻辑的方法，
+     * 完成界面的交互功能配置，使得用户在界面上的操作（如点击按钮、列表项等）能触发相应的功能实现。
+     * @param savedInstanceState 保存的实例状态信息（如果有的话），可以用于恢复之前的界面状态等操作。
+     */
     @Override
     public void onActivityCreated(@Nullable Bundle savedInstanceState) {
         super.onActivityCreated(savedInstanceState);
         onClick();
     }
 
+    /**
+     * 在Fragment中加载数据的抽象方法（这里没有具体实现，可能在父类中有默认逻辑或者根据具体需求在子类中按需实现），
+     * 一般用于发起获取数据等操作来填充界面展示内容（例如获取本地音乐数据等情况），
+     * 具体的加载逻辑可能涉及到与数据层交互、文件读取等操作，不同的业务场景可以有不同的实现方式。
+     */
     @Override
     protected void loadData() {
 
     }
 
+    /**
+     * 获取Fragment对应的布局资源ID，返回fragment_local布局资源的ID，
+     * 表明该Fragment加载对应的这个布局文件来展示界面内容，该布局文件定义了本地音乐界面的整体结构和各个视图组件的布局方式。
+     * @return 布局资源ID，即R.layout.fragment_local，用于告诉系统加载对应的布局文件进行界面展示。
+     */
     @Override
     protected int getLayoutId() {
         return R.layout.fragment_local;
     }
 
-
+    /**
+     * 展示本地音乐列表数据的方法，先清空本地音乐列表集合，再添加传入的音乐列表数据，
+     * 设置RecyclerView为可见，隐藏空视图布局（如果之前显示的话），设置布局管理器，创建并设置本地音乐列表适配器，
+     * 同时为列表项设置点击事件监听，点击时进行一系列歌曲相关信息的设置（如歌曲名称、歌手、播放地址等），
+     * 保存歌曲信息到本地，并调用播放服务的方法开始播放本地音乐，实现了音乐列表展示和点击播放的核心功能。
+     * @param mp3InfoList 本地音乐列表数据集合，包含了本地歌曲的各种相关信息（如名称、歌手、地址等），
+     *                    这些数据将用于在界面上展示每首音乐的详细信息，并在点击时进行播放操作。
+     */
     @Override
     public void showMusicList(final List<LocalSong> mp3InfoList) {
         mLocalSongsList.clear();
@@ -126,11 +207,11 @@ public class LocalFragment extends BaseMvpFragment<LocalPresenter> implements IL
         mRecycler.setVisibility(View.VISIBLE);
         mEmptyViewLinear.setVisibility(View.GONE);
         mRecycler.setLayoutManager(layoutManager);
-        //令recyclerView定位到当前播放的位置
+        // 令recyclerView定位到当前播放的位置，方便用户在播放音乐时能快速定位到正在播放的歌曲所在位置。
         songAdapter = new SongAdapter(mActivity, mLocalSongsList);
         mRecycler.setAdapter(songAdapter);
         songAdapter.setOnItemClickListener(position -> {
-            //将点击的序列化到本地
+            // 将点击的序列化到本地，可能是保存当前点击歌曲的相关信息，方便后续记录用户操作等用途。
             LocalSong mp3Info = mLocalSongsList.get(position);
             Song song = new Song();
             song.setSongName(mp3Info.getName());
@@ -148,41 +229,76 @@ public class LocalFragment extends BaseMvpFragment<LocalPresenter> implements IL
 
     }
 
+    /**
+     * 展示错误视图的方法，通常在本地音乐数据获取出现问题（比如没有本地音乐文件等情况）时调用，
+     * 显示一个Toast提示信息告知用户本地音乐为空，同时隐藏RecyclerView，显示空视图布局，
+     * 提示用户当前无本地音乐可展示，提供友好的用户提示，提升用户体验。
+     */
     @Override
     public void showErrorView() {
         showToast("本地音乐为空");
         mRecycler.setVisibility(View.GONE);
         mEmptyViewLinear.setVisibility(View.VISIBLE);
     }
+
     /**
-     * 注册服务
+     * 注册服务的方法，创建启动播放服务的Intent对象，指定要启动的服务类为PlayerService，
+     * 然后绑定播放服务，通过传入的ServiceConnection对象监听服务连接状态，
+     * 并设置绑定模式为自动创建服务（如果服务未启动则自动启动），用于后续与播放服务的交互操作，
+     * 确保播放服务能正常运行并与Fragment建立通信连接。
      */
     private void registerAndBindReceive() {
-        //启动服务
+        // 创建启动播放服务的Intent对象，指定要启动的服务类为PlayerService，
+        // Intent是Android中用于启动组件（如Activity、Service等）的消息传递对象。
         Intent playIntent = new Intent(getActivity(), PlayerService.class);
+        // 绑定播放服务，通过传入的ServiceConnection对象监听服务连接状态，
+        // 并设置绑定模式为自动创建服务（如果服务未启动则自动启动），
+        // 这样可以保证在需要与播放服务交互时服务已处于运行状态。
         mActivity.bindService(playIntent, connection, Context.BIND_AUTO_CREATE);
     }
 
+ /**
+     * 初始化本地音乐RecyclerView相关设置的方法，创建本地音乐列表集合，创建线性布局管理器，
+     * 清空本地音乐列表集合并从数据库（通过LitePal框架）获取所有本地音乐数据添加到集合中，
+     * 根据音乐列表数据数量判断RecyclerView和空视图布局的显示隐藏状态，
+     * 设置布局管理器，创建并设置本地音乐列表适配器，同时为列表项设置点击事件监听（与showMusicList方法中类似的逻辑），
+     * 点击时进行一系列歌曲相关信息的设置，保存歌曲信息到本地，并调用播放服务的方法开始播放本地音乐，
+     * 全面完成RecyclerView展示本地音乐列表的初始化配置工作。
+     */
     private void initLocalRecycler() {
+        // 创建用于存储本地音乐数据的空集合，后续将从数据库或本地文件扫描获取的音乐信息填充到该集合中。
         mLocalSongsList = new ArrayList<>();
+        // 创建线性布局管理器，设置为垂直方向排列（默认情况），用于管理RecyclerView中本地音乐列表的布局展示，
+        // 确定列表项是垂直排列的，方便用户上下滑动查看不同的音乐。
         layoutManager = new LinearLayoutManager(getActivity());
         mLocalSongsList.clear();
+        // 使用LitePal框架查询获取数据库中所有的本地音乐数据（LocalSong类对应的表数据），添加到本地音乐列表集合中，
+        // LitePal是一个方便的Android数据库操作框架，简化了数据库查询等操作。
         mLocalSongsList.addAll(LitePal.findAll(LocalSong.class));
+        // 如果本地音乐列表集合中没有数据（即没有本地音乐文件），进行相应的界面显示设置。
         if (mLocalSongsList.size() == 0) {
+            // 将RecyclerView设置为不可见，因为没有音乐可展示，避免显示一个空白的列表给用户造成困惑。
             mRecycler.setVisibility(View.GONE);
+            // 将空视图布局设置为可见，用于提示用户当前无本地音乐，例如可以在该布局中显示一段友好的提示文字。
             mEmptyViewLinear.setVisibility(View.VISIBLE);
         } else {
+            // 如果有本地音乐数据，则将空视图布局设置为不可见，准备展示音乐列表。
             mEmptyViewLinear.setVisibility(View.GONE);
+            // 将RecyclerView设置为可见，准备展示本地音乐列表，让用户可以看到并操作音乐列表。
             mRecycler.setVisibility(View.VISIBLE);
+            // 将线性布局管理器设置给RecyclerView，确定其布局方式，使得音乐列表能按照设定的方式展示。
             mRecycler.setLayoutManager(layoutManager);
-            //令recyclerView定位到当前播放的位置
+            // 令recyclerView定位到当前播放的位置，方便用户快速找到正在播放的歌曲。
             songAdapter = new SongAdapter(mActivity, mLocalSongsList);
             mRecycler.setAdapter(songAdapter);
-            if (FileUtil.getSong() != null) {
+            if (FileUtil.getSong()!= null) {
+                // 滚动RecyclerView到指定位置，这里是根据正在播放歌曲的位置进行滚动，
+                // 并设置一定的偏移量（FileUtil.getSong().getPosition() - 4），目的是让正在播放的歌曲在RecyclerView中处于合适的展示位置，
+                // mRecycler.getHeight()可能用于根据RecyclerView的高度来进一步调整滚动的偏移量，以达到更好的视觉效果，使得正在播放的歌曲能更突出显示。
                 layoutManager.scrollToPositionWithOffset(FileUtil.getSong().getPosition() - 4, mRecycler.getHeight());
             }
             songAdapter.setOnItemClickListener(position -> {
-                //将点击的序列化到本地
+                // 将点击的序列化到本地，可能是保存当前点击歌曲的相关信息，方便后续记录用户操作等用途。
                 LocalSong mp3Info = mLocalSongsList.get(position);
                 Song song = new Song();
                 song.setSongName(mp3Info.getName());
@@ -193,18 +309,31 @@ public class LocalFragment extends BaseMvpFragment<LocalPresenter> implements IL
                 song.setOnline(false);
                 song.setSongId(mp3Info.getSongId());
                 song.setListType(Constant.LIST_TYPE_LOCAL);
+                // 通过FileUtil工具类将歌曲相关信息保存到本地，具体保存的方式和位置由FileUtil的实现决定，
+                // 可能是保存到本地文件或者数据库中，方便下次启动应用时能恢复之前的播放状态等操作。
                 FileUtil.saveSong(song);
+                // 通过获取到的与播放服务交互的Binder对象（mPlayStatusBinder）调用播放服务中的播放方法，
+                // 传入Constant.LIST_TYPE_LOCAL表示播放的是本地音乐类型，从而实现点击列表中的本地歌曲后进行播放的功能。
                 mPlayStatusBinder.play(Constant.LIST_TYPE_LOCAL);
             });
 
         }
     }
 
-
+    /**
-    //按钮事件
+     * 设置各种点击事件的监听逻辑的方法，包括查找本地音乐的点击事件和返回上一界面的点击事件。
+     * 点击查找本地音乐的ImageView时，调用Presenter的方法获取本地音乐信息（可能是重新扫描本地音乐文件等操作）；
+     * 点击返回的ImageView时，通过Fragment管理器弹出当前Fragment所在的栈，返回上一界面，
+     * 为用户提供了基本的操作交互功能，方便在界面间进行导航和操作本地音乐相关功能。
+     */
+    // 按钮事件
     private void onClick() {
-        mFindLocalMusicIv.setOnClickListener(v -> mPresenter.getLocalMp3Info()); //得到本地列表
+        // 为查找本地音乐的ImageView设置点击事件监听，点击时调用Presenter的方法获取本地音乐列表信息，
-        mBackIv.setOnClickListener(v -> Objects.requireNonNull(getActivity()).getSupportFragmentManager().popBackStack()); //返回
+        // 比如可能触发重新扫描本地存储设备查找新添加的音乐文件等操作，以更新本地音乐列表展示。
+        mFindLocalMusicIv.setOnClickListener(v -> mPresenter.getLocalMp3Info());
+        // 为返回的ImageView设置点击事件监听，点击时通过Fragment管理器弹出栈，返回上一界面，
+        // FragmentManager负责管理Fragment的添加、替换、移除以及返回栈等操作，popBackStack方法会将当前Fragment从栈顶弹出，显示上一个Fragment的界面。
+        mBackIv.setOnClickListener(v -> Objects.requireNonNull(getActivity()).getSupportFragmentManager().popBackStack());
     }
 
 }