diff --git a/app/src/main/java/com/example/musicplayer/contract/IPlayContract.java b/app/src/main/java/com/example/musicplayer/contract/IPlayContract.java index d594617..a191f35 100644 --- a/app/src/main/java/com/example/musicplayer/contract/IPlayContract.java +++ b/app/src/main/java/com/example/musicplayer/contract/IPlayContract.java @@ -1,37 +1,145 @@ package com.example.musicplayer.contract; +// 导入所需的包和类 import com.example.musicplayer.base.presenter.IPresenter; import com.example.musicplayer.base.view.BaseView; import com.example.musicplayer.entiy.Song; /** - * Created by 残渊 on 2018/10/26. + * 定义了播放模块的契约类,包含视图(View)和 presenter 之间的接口。 + *
+ * author : 残渊
+ * time : 2018/10/26
+ * desc : 规定了播放模块中视图和 presenter 需要实现的方法。
*/
-
public interface IPlayContract {
+ /**
+ * 定义了视图(View)需要实现的方法。
+ */
interface View extends BaseView {
- String getSingerName(); //得到歌手的姓名
- void getSingerAndLrc();//按钮点击事件,获取封面和歌词
- void setSingerImg(String ImgUrl); //将图片设置成背景
- void showLove(boolean love); //判断是否显示我喜欢的图标
- void showLoveAnim(); //喜欢的动画
- void saveToLoveSuccess();//保存到我喜欢数据库成功
- void sendUpdateCollection(); //发送广播更新收藏列表
- void showLrc(String lrc);//显示歌词
- void getLrcError(String content);//获取不到歌词
- void setLocalSongId(String songId); //设置本地音乐的songId
- void getSongIdSuccess(String songId);//成功获取到该音乐的id
- void saveLrc(String lrc);//保存歌词
+ /**
+ * 获取歌手的姓名。
+ * @return 歌手姓名。
+ */
+ String getSingerName();
+
+ /**
+ * 按钮点击事件,获取封面和歌词。
+ */
+ void getSingerAndLrc();
+
+ /**
+ * 将图片设置成背景。
+ * @param ImgUrl 背景图片的URL。
+ */
+ void setSingerImg(String ImgUrl);
+
+ /**
+ * 判断是否显示我喜欢的图标。
+ * @param love 是否喜欢。
+ */
+ void showLove(boolean love);
+
+ /**
+ * 显示喜欢的动画。
+ */
+ void showLoveAnim();
+
+ /**
+ * 保存到我喜欢数据库成功。
+ */
+ void saveToLoveSuccess();
+
+ /**
+ * 发送广播更新收藏列表。
+ */
+ void sendUpdateCollection();
+
+ /**
+ * 显示歌词。
+ * @param lrc 歌词内容。
+ */
+ void showLrc(String lrc);
+
+ /**
+ * 获取不到歌词时显示错误信息。
+ * @param content 错误内容。
+ */
+ void getLrcError(String content);
+
+ /**
+ * 设置本地音乐的songId。
+ * @param songId 歌曲ID。
+ */
+ void setLocalSongId(String songId);
+
+ /**
+ * 成功获取到该音乐的id。
+ * @param songId 歌曲ID。
+ */
+ void getSongIdSuccess(String songId);
+
+ /**
+ * 保存歌词。
+ * @param lrc 歌词内容。
+ */
+ void saveLrc(String lrc);
}
+
+ /**
+ * 定义了 presenter 需要实现的方法。
+ */
interface Presenter extends IPresenter