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,31 +204,66 @@ 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,82 +6,194 @@ 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;
-    }
-
-    public void setMediaId(String mediaId) {
-        this.mediaId = mediaId;
-    }
-
-    public void setDownload(boolean download) {
-        isDownload = download;
-    }
-
-    public boolean isDownload() {
-        return isDownload;
-    }
-}
+/**
+ * 获取下载标识符的方法，外部代码调用此方法后，会得到一个字符串，该字符串就是当前HistorySong对象对应的下载标识符，
+ * 在涉及追溯歌曲的下载情况、区分不同播放来源以及基于下载相关业务逻辑（如断点续播等）的操作中，
+ * 这个标识符起到了关键

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

@@ -4,81 +4,225 @@ import org.litepal.LitePal;
 import org.litepal.crud.LitePalSupport;
 
 /**
- * Created by 残渊 on 2018/10/10.
+ * <pre>
+ *     author : 残渊
+ *     time   : 2018/10/10
+ *     desc   : 该类用于表示本地歌曲的相关信息实体，旨在对存储在本地设备中的歌曲各项关键属性进行记录和管理，
+ *              方便音乐播放器在本地音乐播放场景下，对这些歌曲进行展示、播放以及相关操作的处理等。
+ * </pre>
  */
-
-public class LocalSong extends LitePalSupport{
+// LocalSong类继承自LitePalSupport类，这样它就能借助LitePal框架提供的便捷功能，轻松实现与本地数据库的交互操作，
+// 例如可以方便地将本地歌曲信息保存到数据库中（持久化存储），从数据库里查询符合特定条件的本地歌曲记录，
+// 更新已有本地歌曲记录的属性值，或者删除不再需要的本地歌曲记录等，有助于高效地管理本地歌曲数据资源。
+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>
  */
-
-public class Love extends LitePalSupport{
+// Love类继承自LitePalSupport类，这使得它能够利用LitePal框架提供的功能，便捷地与数据库进行交互，
+// 比如可以将用户喜爱歌曲的信息持久化存储到数据库中，方便后续查询、更新这些喜爱歌曲的记录，或者根据业务需求删除某些不再喜爱的歌曲记录等，
+// 有助于有效地管理用户的歌曲喜好数据。
+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;
-    }
-
-    public void setMediaId(String mediaId) {
-        this.mediaId = mediaId;
-    }
-
-    public boolean isDownload() {
-        return isDownload;
+    /**
+     * 设置与QQ音乐平台相关的唯一标识（推测用途）的方法，当在与QQ音乐的数据交互过程中，获取到了新的标识信息或者需要更新该标识时，
+     * 外部代码可以通过传入新的QQ音乐相关标识字符串作为参数，来更新当前Love对象中的qqId属性，
+     * 确保跨平台数据关联的准确性和有效性，便于更好地整合和利用QQ音乐相关的数据资源。
+     * @param qqId 要设置的QQ音乐相关标识的字符串。
+     */
+    public void setQqId(String qqId) {
+        this.qqId = qqId;
     }
 
-    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,107 +4,190 @@ 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,27 +4,60 @@ 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,26 +3,68 @@ 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
-     * 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 :
+     * 用于存储表示状态码之类的整数值，可能不同的值代表不同的请求响应状态，比如0可能表示成功等。
      */
-
     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 : 邓紫棋
-         * 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}
+         * 存储一个SongBean类型的对象，这个对象应该包含了歌曲具体信息相关的数据内容，比如歌曲列表、歌曲数量等。
          */
-
-
         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
-                 * 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 :
+                 * 专辑的唯一标识ID，用于区分不同的专辑，方便关联查询专辑的其他详细信息等。
                  */
-
                 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) {
-                    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 void setSizeflac(int sizeflac) {
+                        // 设置FLAC格式歌曲文件大小的方法，将传入的参数赋值给当前对象的sizeflac属性，以便更新歌曲该格式文件大小信息
+                        this.sizeflac = sizeflac;
+                    }
 
-                public int getStream() {
-                    return stream;
-                }
+                    public int getSizeogg() {
+                        // 获取OGG格式歌曲文件大小的方法，用于在其他地方获取当前歌曲的OGG格式文件大小数值
+                        return sizeogg;
+                    }
 
-                public void setStream(int stream) {
-                    this.stream = stream;
-                }
+                    public void setSizeogg(int sizeogg) {
+                        // 设置OGG格式歌曲文件大小的方法，把传入的sizeogg参数赋值给当前对象对应的属性，实现文件大小信息更新
+                        this.sizeogg = sizeogg;
+                    }
 
-                public int getSwitchX() {
-                    return switchX;
-                }
+                    public int getSongid() {
+                        // 获取歌曲唯一标识ID的方法，方便在整个业务逻辑中通过这个ID来准确区分和操作不同的歌曲
+                        return songid;
+                    }
 
-                public void setSwitchX(int switchX) {
-                    this.switchX = switchX;
-                }
+                    public void setSongid(int songid) {
+                        // 设置歌曲唯一标识ID的方法，外部传入的songid参数会被赋给当前对象的songid属性，以此来确定歌曲的唯一标识
+                        this.songid = songid;
+                    }
 
-                public int getT() {
-                    return t;
-                }
+                    public String getSongmid() {
+                        // 获取歌曲中间标识字符串的方法，在涉及歌曲相关的特定业务操作（比如和某些接口交互等）中，可能会用到这个标识来识别歌曲
+                        return songmid;
+                    }
 
-                public void setT(int t) {
-                    this.t = t;
-                }
+                    public void setSongmid(String songmid) {
+                        // 设置歌曲中间标识字符串的方法，将传入的songmid参数赋值给当前对象对应的属性，更新歌曲的这个标识信息
+                        this.songmid = songmid;
+                    }
 
-                public int getTag() {
-                    return tag;
-                }
+                    public String getSongname() {
+                        // 获取歌曲名称的方法，用于展示给用户看具体是哪首歌曲，或者在一些业务处理中根据歌曲名称进行相关操作
+                        return songname;
+                    }
 
-                public void setTag(int tag) {
-                    this.tag = tag;
-                }
+                    public void setSongname(String songname) {
+                        // 设置歌曲名称的方法，通过传入的参数来更新当前对象的歌曲名称属性，改变歌曲对应的显示名称
+                        this.songname = songname;
+                    }
 
-                public int getType() {
-                    return type;
-                }
+                    public String getSongname_hilight() {
+                        // 获取歌曲名称高亮显示版本的方法，在搜索结果展示等需要突出显示关键词的场景下，获取这个高亮处理后的名称进行展示
+                        return songname_hilight;
+                    }
 
-                public void setType(int type) {
-                    this.type = type;
-                }
+                    public void setSongname_hilight(String songname_hilight) {
+                        // 设置歌曲名称高亮显示版本的方法，将传入的高亮名称参数赋值给对应的属性，更新歌曲名称的高亮显示内容
+                        this.songname_hilight = songname_hilight;
+                    }
 
-                public int getVer() {
-                    return ver;
-                }
+                    public String getStrMediaMid() {
+                        // 获取字符串形式的媒体中间标识的方法，和media_mid类似，可能在不同的业务环节用于歌曲媒体相关的识别等操作
+                        return strMediaMid;
+                    }
 
-                public void setVer(int ver) {
-                    this.ver = ver;
-                }
+                    public void setStrMediaMid(String strMediaMid) {
+                        // 设置字符串形式的媒体中间标识的方法，将传入的参数赋值给对应属性，更新这个媒体相关的标识信息
+                        this.strMediaMid = strMediaMid;
+                    }
 
+                    public int getStream() {
+                        // 获取可能表示是否能在线播放之类标识的方法，不同的值（比如1表示可以播放，0表示不能等）代表不同的播放状态，供业务逻辑判断使用
+                        return stream;
+                    }
 
-                public List<SingerBean> getSinger() {
-                    return singer;
-                }
+                    public void setStream(int stream) {
+                        // 设置是否能在线播放标识的方法，外部传入的stream参数会更新当前对象对应的属性，改变歌曲的播放状态标识
+                        this.stream = stream;
+                    }
 
-                public void setSinger(List<SingerBean> singer) {
-                    this.singer = singer;
-                }
+                    public int getSwitchX() {
+                        // 获取可能是某种切换相关标识的方法，比如涉及播放源切换等情况时，通过这个标识来判断是否需要切换以及切换的相关状态，具体含义依赖业务场景设定
+                        return switchX;
+                    }
 
+                    public void setSwitchX(int switchX) {
+                        // 设置切换相关标识的方法，将传入的switchX参数赋值给对应属性，更新歌曲的这个切换相关标识信息
+                        this.switchX = switchX;
+                    }
 
-                public static class SingerBean {
-                    /**
-                     * id : 13948
-                     * mid : 001fNHEf1SFEFN
-                     * name : G.E.M. 邓紫棋
-                     * name_hilight : G.E.M. <em>邓紫棋</em>
-                     */
+                    public int getT() {
+                        // 获取可能是某种类型标识的方法，例如歌曲风格类型等也许会用不同值来区分，具体含义由业务逻辑确定，供业务处理时参考判断歌曲的相关类型情况
+                        return t;
+                    }
 
-                    private int id;
-                    private String mid;
-                    private String name;
-                    private String name_hilight;
+                    public void setT(int t) {
+                        // 设置某种类型标识的方法，传入的t参数会更新当前对象对应的属性，改变这个类型标识的取值
+                        this.t = t;
+                    }
 
-                    public int getId() {
-                        return id;
+                    public int getTag() {
+                        // 获取标签标识的方法，在歌曲打不同标签分类等业务场景下，通过这个标识来知晓歌曲所属的标签类别，不同值代表不同标签含义
+                        return tag;
                     }
 
-                    public void setId(int id) {
-                        this.id = id;
+                    public void setTag(int tag) {
+                        // 设置标签标识的方法，外部传入的tag参数会赋值给对应属性，以此更新歌曲的标签分类标识
+                        this.tag = tag;
                     }
 
-                    public String getMid() {
-                        return mid;
+                    public int getType() {
+                        // 获取歌曲类型标识的方法，比如区分是原创、翻唱等不同类型的歌曲，业务中根据这个标识来进行相应的不同处理逻辑
+                        return type;
                     }
 
-                    public void setMid(String mid) {
-                        this.mid = mid;
+                    public void setType(int type) {
+                        // 设置歌曲类型标识的方法，将传入的type参数赋值给对应属性，改变歌曲的类型标识取值，更新其类型相关信息
+                        this.type = type;
                     }
 
-                    public String getName() {
-                        return name;
+                    public int getVer() {
+                        // 获取版本相关标识的方法，比如歌曲的版本号等，用于在业务处理中判断歌曲是否是不同版本，进而进行对应的版本相关操作
+                        return ver;
                     }
 
-                    public void setName(String name) {
-                        this.name = name;
+                    public void setVer(int ver) {
+                        // 设置版本相关标识的方法，传入的ver参数会更新当前对象的版本标识属性，改变歌曲对应的版本相关信息
+                        this.ver = ver;
                     }
 
-                    public String getName_hilight() {
-                        return name_hilight;
+
+                    public List<SingerBean> getSinger() {
+                        // 获取参与演唱这首歌曲的歌手信息列表的方法，方便在业务逻辑中获取所有参与演唱的歌手详细情况，比如展示歌手名字等操作
+                        return singer;
                     }
 
-                    public void setName_hilight(String name_hilight) {
-                        this.name_hilight = name_hilight;
+                    public void setSinger(List<SingerBean> singer) {
+                        // 设置参与演唱这首歌曲的歌手信息列表的方法，传入的歌手信息列表参数会替换当前对象保存的歌手列表，更新歌曲对应的歌手信息
+                        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,102 +4,114 @@ 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}]}
-     * code : 200
+     * 存储一个ResultBean类型的对象，这个对象应该包含了查询歌手图片相关操作后的具体结果数据，比如包含歌手列表以及对应的各种图片链接等详细信息。
      */
-
     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
-             * 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
+             * 歌手的唯一标识ID，用于区分不同的歌手个体，在整个音乐业务系统中可通过这个ID来准确查找、关联歌手的其他相关资料等。
              */
-
             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,145 +1,187 @@
 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
-    private String qqId;//专属本地音乐，本地音乐在qq音乐中的songId
-    private String mediaId;//播放id,下载需要用到
-   private String singer; //歌手
-    private long duration; //总时长
-    private String songName; //歌曲名字
-    private String url;  //歌曲url
-    private long currentTime; //歌曲播放时长位置
-    private int position;//在音乐列表的位置
-    private String imgUrl; //歌曲照片
-    private boolean isOnline; //是否为网络歌曲
-    private int listType; //歌曲列表类别,0表示当前没有列表，即可能在播放网络歌曲
-    private boolean isDownload;//是否为下载的歌曲
-
-
+    // 歌曲自身的ID，用于唯一标识一首歌曲，可能是音乐平台分配的特定标识，方便在业务逻辑中通过这个ID来查找、操作对应的歌曲信息。
+    private String songId;
+    // 专属本地音乐对应的QQ音乐中的歌曲ID，用于和QQ音乐相关联，针对本地音乐在QQ音乐体系下的标识，便于进行一些跨平台或特定QQ音乐相关操作时使用。
+    private String qqId;
+    // 播放ID，在进行歌曲下载等操作时可能会用到，也许是用于向服务器请求播放资源或者下载资源时的一个关键标识。
+    private String mediaId;
+    // 演唱这首歌曲的歌手名称，用于展示歌曲的演唱者信息给用户，也是区分不同歌曲的重要属性之一。
+    private String singer;
+    // 歌曲的总时长，通常以秒或者毫秒等时间单位来计量，方便在播放界面展示歌曲时长以及进行播放进度相关的计算等操作。
+    private long duration;
+    // 歌曲的名称，是展示给用户最直观的信息，用于识别具体是哪一首歌曲。
+    private String songName;
+    // 歌曲的资源链接（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
                 +",songId="+songId+",isOnline="+isOnline+",listType="+listType;
 
     }
-}
+}

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
-     * 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 :
+     * 可能用于表示请求歌词相关操作的响应状态码，例如0可能表示获取歌词成功等，不同的值对应不同的请求处理结果情况。
      */
-
     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
-         * qc : []
-         * tab : 7
-         * taglist : []
-         * totaltime : 0
-         * zhida : {"chinesesinger":0,"type":0}
+         * 搜索歌词时使用的关键词，可能是歌曲名、歌手名等用于定位查找对应歌词的关键信息，方便在歌词库中检索到准确的歌词内容。
+         */
+        private String keyword;
+        /**
+         * 存储一个LyricBean类型的对象，这个对象封装了歌词主体相关的详细信息，比如歌词的分页情况、具体的歌词文本内容等。
          */
-
         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
-                 * 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 :
+                 * 可能表示是否是中文歌手相关的标识，0或1等不同值来区分，具体含义依赖业务规则，用于判断歌曲演唱者相关语言属性情况，和歌词可能有一定关联（比如中文歌词对应中文歌手等情况的判断）。
                  */
                 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
-                     * mid : 001f0VyZ1hmWZ1
-                     * name : 林宥嘉
-                     * name_hilight : 林宥嘉
+                     * 歌手的唯一标识ID，用于区分不同的歌手个体，在整个业务系统中可以通过这个ID准确查找、关联歌手的其他相关资料（如专辑、代表作等），
+                     * 比如在数据库查询、数据关联等操作中作为关键的识别依据。
                      */
-
                     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;
                     }
-                }
-            }
-        }
-    }
-}
+                }