snow.player.playlist

接口 PlaylistEditor

所有已知实现类:

PlayerClient, PlayerService

public interface PlaylistEditor

该接口定义了播放列表编辑器的基本功能。

另请参阅:

PlayerClient

方法概要

限定符和类型	方法和说明
void	appendMusicItem(MusicItem musicItem) 往播放列表的末尾添加一首歌曲。
void	insertMusicItem(int position, MusicItem musicItem) 往列表中插入了一首新的歌曲。
void	moveMusicItem(int fromPosition, int toPosition) 移动播放列表中某首歌曲的位置。
void	removeMusicItem(int position) 移除播放列表中指定位置的歌曲。
void	removeMusicItem(MusicItem musicItem) 从播放列表中移除了指定歌曲。
void	setNextPlay(MusicItem musicItem) 设置 “下一次播放” 的歌曲。
void	setPlaylist(Playlist playlist, int position, boolean play) 设置一个新的播放列表。

方法详细资料

insertMusicItem

void insertMusicItem(int position,
                     @NonNull
                     MusicItem musicItem)

往列表中插入了一首新的歌曲。

如果播放列表中已包含指定歌曲，则会将它移动到 position 位置，如果不存在，则会将歌曲插入到 position 位置。

参数:

position - 歌曲插入的位置

musicItem - 要插入的歌曲，不能为 null

appendMusicItem

void appendMusicItem(@NonNull
                     MusicItem musicItem)

往播放列表的末尾添加一首歌曲。

如果播放列表中已包含指定歌曲，则会将它移动到播放列表的末尾位置，如果不存在，则会将歌曲添加到播放列表的末尾。

参数:

musicItem - 要添加播放列表末尾的歌曲，不能为 null

moveMusicItem

void moveMusicItem(int fromPosition,
                   int toPosition)

移动播放列表中某首歌曲的位置。

参数:

fromPosition - 歌曲在列表中的位置

toPosition - 歌曲要移动到的位置。如果 toPosition == fromPosition，则会忽略本次调用

removeMusicItem

void removeMusicItem(@NonNull
                     MusicItem musicItem)

从播放列表中移除了指定歌曲。

参数:

musicItem - 要移除的歌曲。如果播放列表中不包含该歌曲，则忽略本次调用

removeMusicItem

void removeMusicItem(int position)

移除播放列表中指定位置的歌曲。

参数:

position - 要移除的歌曲的位置

setNextPlay

void setNextPlay(@NonNull
                 MusicItem musicItem)

设置 “下一次播放” 的歌曲。

参数:

musicItem - 要设定为 “下一次播放” 的歌曲，如果歌曲已存在播放列表中，则会移动到 “下一曲播放” 的位 置，如果歌曲不存在，则插入到 “下一曲播放” 位置

setPlaylist

void setPlaylist(Playlist playlist,
                 int position,
                 boolean play)

设置一个新的播放列表。

参数:

playlist - 播放列表（不能为 null）

position - 播放列表中要播放的歌曲的位置

play - 是否立即播放 position 参数指定处的音乐