PlayerClient

java.lang.Object
- snow.player.PlayerClient

所有已实现的接口:

Player, PlayerManager, PlaylistEditor, PlaylistManager, SleepTimer
```
public class PlayerClient
extends java.lang.Object
implements Player, PlayerManager, PlaylistManager, PlaylistEditor, SleepTimer
```
播放器客户端，用于向播放器发送各种控制命令。

嵌套类概要

嵌套类
限定符和类型	类和说明
`static interface`	`PlayerClient.OnAudioSessionChangeListener` 用于监听播放器的 audio session id 改变事件。
`static interface`	`PlayerClient.OnConnectCallback` 用于监听播放器是否连接成功。
`static interface`	`PlayerClient.OnConnectStateChangeListener` 用于监听 PlayerClient 的连接成功与断开连接事件。
`static interface`	`PlayerClient.OnPlaybackStateChangeListener` 用于监听播放器播放状态的改变。

从接口继承的嵌套类/接口 snow.player.Player
Player.OnBufferedProgressChangeListener, Player.OnPlayingMusicItemChangeListener, Player.OnPlaylistChangeListener, Player.OnPlayModeChangeListener, Player.OnPrepareListener, Player.OnRepeatListener, Player.OnSeekCompleteListener, Player.OnSpeedChangeListener, Player.OnStalledChangeListener

从接口继承的嵌套类/接口 snow.player.playlist.PlaylistManager
PlaylistManager.Callback

从接口继承的嵌套类/接口 snow.player.SleepTimer
SleepTimer.OnStateChangeListener, SleepTimer.TimeoutAction

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`addOnAudioSessionChangeListener(androidx.lifecycle.LifecycleOwner owner, PlayerClient.OnAudioSessionChangeListener listener)` 监听播放器的 audio session id 如果监听器已添加，则忽略本次调用。
`void`	`addOnAudioSessionChangeListener(PlayerClient.OnAudioSessionChangeListener listener)` 添加一个 audio session id 监听器。
`void`	`addOnBufferedProgressChangeListener(androidx.lifecycle.LifecycleOwner owner, Player.OnBufferedProgressChangeListener listener)` 添加一个缓存进度监听器。
`void`	`addOnBufferedProgressChangeListener(Player.OnBufferedProgressChangeListener listener)` 添加一个缓存进度监听器。
`void`	`addOnConnectStateChangeListener(androidx.lifecycle.LifecycleOwner owner, PlayerClient.OnConnectStateChangeListener listener)` 添加一个 `PlayerClient.OnConnectStateChangeListener` 监听器用来监听 `PlayerClient` 的连接成功与断开连接事件。
`void`	`addOnConnectStateChangeListener(PlayerClient.OnConnectStateChangeListener listener)` 添加一个监听器用来监听 PlayerClient 连接断开事件。
`void`	`addOnPlaybackStateChangeListener(androidx.lifecycle.LifecycleOwner owner, Player.OnPlaybackStateChangeListener listener)` 添加一个播放器播放状态监听器。
`void`	`addOnPlaybackStateChangeListener(androidx.lifecycle.LifecycleOwner owner, PlayerClient.OnPlaybackStateChangeListener listener)` 监听播放器状态。
`void`	`addOnPlaybackStateChangeListener(Player.OnPlaybackStateChangeListener listener)` 添加一个播放器播放状态监听器。
`void`	`addOnPlaybackStateChangeListener(PlayerClient.OnPlaybackStateChangeListener listener)` 监听播放器状态。
`void`	`addOnPlayingMusicItemChangeListener(androidx.lifecycle.LifecycleOwner owner, Player.OnPlayingMusicItemChangeListener listener)` 添加一个监听当前播放的 MusicItem 改变事件的监听器。
`void`	`addOnPlayingMusicItemChangeListener(Player.OnPlayingMusicItemChangeListener listener)` 添加一个监听当前播放的 MusicItem 改变事件的监听器。
`void`	`addOnPlaylistChangeListener(androidx.lifecycle.LifecycleOwner owner, Player.OnPlaylistChangeListener listener)` 添加一个用于监听播放列表改变事件的监听器。
`void`	`addOnPlaylistChangeListener(Player.OnPlaylistChangeListener listener)` 添加一个用于监听播放列表改变事件的监听器。
`void`	`addOnPlayModeChangeListener(androidx.lifecycle.LifecycleOwner owner, Player.OnPlayModeChangeListener listener)` 添加一个用于监听播放模式改变的监听器。
`void`	`addOnPlayModeChangeListener(Player.OnPlayModeChangeListener listener)` 添加一个用于监听播放模式改变的监听器。
`void`	`addOnPrepareListener(androidx.lifecycle.LifecycleOwner owner, Player.OnPrepareListener listener)` 添加一个播放器准备（prepare）状态监听器。
`void`	`addOnPrepareListener(Player.OnPrepareListener listener)` 添加一个播放器准备（prepare）状态监听器。
`void`	`addOnRepeatListener(androidx.lifecycle.LifecycleOwner owner, Player.OnRepeatListener listener)` 添加一个 `Player.OnRepeatListener` 监听器。
`void`	`addOnRepeatListener(Player.OnRepeatListener listener)` 添加一个 `Player.OnRepeatListener` 监听器。
`void`	`addOnSeekCompleteListener(androidx.lifecycle.LifecycleOwner owner, Player.OnSeekCompleteListener listener)` 添加一个用于监听播放器播放进度调整完毕事件的监听器。
`void`	`addOnSeekCompleteListener(Player.OnSeekCompleteListener listener)` 添加一个用于监听播放器播放进度调整完毕事件的监听器。
`void`	`addOnSleepTimerStateChangeListener(androidx.lifecycle.LifecycleOwner owner, SleepTimer.OnStateChangeListener listener)` 监听睡眠定时器的状态。
`void`	`addOnSleepTimerStateChangeListener(SleepTimer.OnStateChangeListener listener)` 监听睡眠定时器的状态。
`void`	`addOnSpeedChangeListener(androidx.lifecycle.LifecycleOwner owner, Player.OnSpeedChangeListener listener)` 添加一个用于监听播放速度改变的监听器。
`void`	`addOnSpeedChangeListener(Player.OnSpeedChangeListener listener)` 添加一个用于监听播放速度改变的监听器。
`void`	`addOnStalledChangeListener(androidx.lifecycle.LifecycleOwner owner, Player.OnStalledChangeListener listener)` 添加一个 stalled 状态监听器。
`void`	`addOnStalledChangeListener(Player.OnStalledChangeListener listener)` 添加一个 stalled 状态监听器。
`void`	`appendMusicItem(MusicItem musicItem)` 往播放列表的末尾添加一首歌曲。
`void`	`cancelSleepTimer()` 取消睡眠定时器。
`void`	`connect()` 连接播放器。
`void`	`connect(PlayerClient.OnConnectCallback callback)` 连接播放器
`void`	`disconnect()` 断开与播放器的连接。
`void`	`fastForward()` 快进。
`android.os.Bundle`	`getAudioEffectConfig()` 获取音频特效的配置。
`int`	`getAudioSessionId()` 获取 audio session id。
`int`	`getBufferedProgress()` 获取当前的缓存进度。
`int`	`getErrorCode()` 获取错误码。
`java.lang.String`	`getErrorMessage()` 获取错误信息。
`long`	`getLastModified()` 获取最后一次修改播放列表的时间。
`android.support.v4.media.session.MediaControllerCompat`	`getMediaController()` 获取 `MediaControllerCompat` 对象。
`PlaybackState`	`getPlaybackState()` 获取当前播放状态。
`MusicItem`	`getPlayingMusicItem()` 获取当前正在播放的音乐。
`int`	`getPlayingMusicItemDuration()` 获取当前正在播放的音乐的持续时间。
`void`	`getPlaylist(PlaylistManager.Callback callback)` 以异步的方式获取播放队列。
`PlaylistManager`	`getPlaylistManager()` 获取当前 PlayerController 的 PlaylistManager 对象。
`java.lang.String`	`getPlaylistName()` 获取播放列表的名称。
`int`	`getPlaylistSize()` 获取当前播放队列的大小。
`java.lang.String`	`getPlaylistToken()` 获取播放列表的 Token
`PlayMode`	`getPlayMode()` 获取当前播放模式。
`int`	`getPlayPosition()` 获取当前播放列表的播放位置。
`int`	`getPlayProgress()` 获取播放进度（单位：毫秒）。
`long`	`getPlayProgressUpdateTime()` 获取播放进度的更新时间。
`long`	`getSleepTimerElapsedTime()` 获取睡眠定时器已经走过的时间。
`long`	`getSleepTimerStartedTime()` 获取睡眠定时器的启动时间。
`long`	`getSleepTimerTime()` 获取睡眠定时器的定时时间。
`SoundQuality`	`getSoundQuality()` 获取当前播放器的首选音质。
`float`	`getSpeed()` 获取播放速度。
`SleepTimer.TimeoutAction`	`getTimeoutAction()` 获取睡眠定时器的时间到时要执行的操作。
`void`	`insertMusicItem(int position, MusicItem musicItem)` 往列表中插入了一首新的歌曲。
`boolean`	`isAudioEffectEnabled()` 是否已启用音频特效。
`boolean`	`isAutoConnect()` 是否已经启用自动连接。
`boolean`	`isConnected()` 判断播放器是否已连接。
`boolean`	`isError()` 播放器是否发生了错误。
`boolean`	`isForbidSeek()` 判断是否禁用了所有的 seek 操作。
`boolean`	`isIgnoreAudioFocus()` 是否忽略音频焦点。
`boolean`	`isLooping()` 是否单曲循环播放。
`boolean`	`isOnlyWifiNetwork()` 是否只允许使用 Wifi 网络（默认为 false）。
`boolean`	`isPlaying()` 播放器当前是否处于 `PlaybackState.PLAYING` 状态。
`boolean`	`isPlaylistEditable()` 播放列表是否是可编辑的。
`boolean`	`isPrepared()` 播放器是否准备完毕。
`boolean`	`isPreparing()` 播放器是否正在准备中。
`boolean`	`isSleepTimerStarted()` 查询睡眠定时器是否已启动。
`boolean`	`isStalled()` 当前播放器是否处于 stalled 状态。
`void`	`moveMusicItem(int fromPosition, int toPosition)` 移动播放列表中某首歌曲的位置。
`static PlayerClient`	`newInstance(android.content.Context context, java.lang.Class<? extends PlayerService> playerService)` 创建一个 PlayerClient 对象。
`void`	`pause()` 暂停播放。
`void`	`play()` 开始播放。
`void`	`playPause()` 播放/暂停。
`void`	`playPause(int position)` 播放或暂停播放列表中指定索引处的音乐。
`void`	`removeMusicItem(int position)` 移除播放列表中指定位置的歌曲。
`void`	`removeMusicItem(MusicItem musicItem)` 从播放列表中移除了指定歌曲。
`void`	`removeOnAudioSessionChangeListener(PlayerClient.OnAudioSessionChangeListener listener)` 移除 audio session id 监听器。
`void`	`removeOnBufferedProgressChangeListener(Player.OnBufferedProgressChangeListener listener)` 移除缓存进度监听器。
`void`	`removeOnConnectStateChangeListener(PlayerClient.OnConnectStateChangeListener listener)` 移除已添加的 `PlayerClient.OnConnectStateChangeListener` 监听器对象。
`void`	`removeOnPlaybackStateChangeListener(Player.OnPlaybackStateChangeListener listener)` 移除播放器播放状态监听器。
`void`	`removeOnPlaybackStateChangeListener(PlayerClient.OnPlaybackStateChangeListener listener)` 移除播放器状态监听器。
`void`	`removeOnPlayingMusicItemChangeListener(Player.OnPlayingMusicItemChangeListener listener)` 移除当前播放的 MusicItem 改变事件监听器
`void`	`removeOnPlaylistChangeListener(Player.OnPlaylistChangeListener listener)` 移除用于监听播放列表改变事件的监听器。
`void`	`removeOnPlayModeChangeListener(Player.OnPlayModeChangeListener listener)` 移除一个用于监听播放模式改变的监听器。
`void`	`removeOnPrepareListener(Player.OnPrepareListener listener)` 移除一个播放器准备（prepare）状态监听器。
`void`	`removeOnRepeatListener(Player.OnRepeatListener listener)` 异常已注册的 `Player.OnRepeatListener` 监听器。
`void`	`removeOnSeekCompleteListener(Player.OnSeekCompleteListener listener)` 移除用于监听播放器播放进度调整完毕的监听器。
`void`	`removeOnSleepTimerStateChangeListener(SleepTimer.OnStateChangeListener listener)` 移除已注册的睡眠定时器状态监听器。
`void`	`removeOnSpeedChangeListener(Player.OnSpeedChangeListener listener)` 移除一个用于监听播放模式改变的监听器。
`void`	`removeOnStalledChangeListener(Player.OnStalledChangeListener listener)` 移除 stalled 状态监听器。
`void`	`rewind()` 快退。
`void`	`seekTo(int progress)` 调整音乐播放进度（单位：毫秒）。
`void`	`sendCustomAction(java.lang.String action, android.os.Bundle args)` 发送自定义动作。
`void`	`setAudioEffectConfig(android.os.Bundle config)` 修改音频特效的配置。
`void`	`setAudioEffectEnabled(boolean enabled)` 设置是否启用音频特效（如：均衡器）（默认为 false）。
`void`	`setAutoConnect(boolean autoConnect)` 设置是否启用自动连接功能。
`void`	`setIgnoreAudioFocus(boolean ignoreAudioFocus)` 设置是否忽略音频焦点。
`void`	`setNextPlay(MusicItem musicItem)` 设置 “下一次播放” 的歌曲。
`void`	`setOnlyWifiNetwork(boolean onlyWifiNetwork)` 设置是否只允许在 WiFi 网络下播放音乐（默认为 false）。
`void`	`setPlaylist(Playlist playlist)` 设置一个新的播放列表。
`void`	`setPlaylist(Playlist playlist, boolean play)` 设置一个新的播放列表。
`void`	`setPlaylist(Playlist playlist, int position, boolean play)` 设置一个新的播放列表。
`void`	`setPlayMode(PlayMode playMode)` 设置播放模式。
`void`	`setSoundQuality(SoundQuality soundQuality)` 设置播放器的首选音质（默认为 `SoundQuality.STANDARD`）。
`void`	`setSpeed(float speed)` 设置播放速度。
`void`	`shutdown()` 关闭播放器。
`void`	`skipToNext()` 下一曲。
`void`	`skipToPosition(int position)` 播放 position 处的音乐，如果播放列表中 position 处的音乐是当前正在播放的音乐，则忽略本次调用。
`void`	`skipToPrevious()` 上一曲。
`void`	`startSleepTimer(long time)` 启动睡眠定时器。
`void`	`startSleepTimer(long time, SleepTimer.TimeoutAction action)` 启动睡眠定时器。
`void`	`stop()` 停止播放。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - newInstance
```
public static PlayerClient newInstance(@NonNull
                                       android.content.Context context,
                                       @NonNull
                                       java.lang.Class<? extends PlayerService> playerService)
```
    创建一个 PlayerClient 对象。
    
    参数:
    
    context - Context 对象，不能为 null
    
    playerService - PlayerService 或者其子类的 Class 对象，不能为 null
    
    返回:
    
    PlayerClient 对象
  - connect
```
public void connect()
```
    连接播放器。
  - connect
```
public void connect(PlayerClient.OnConnectCallback callback)
```
    连接播放器
    
    参数:
    
    callback - 回调接口，用于接收连接结果
  - disconnect
```
public void disconnect()
```
    断开与播放器的连接。
    断开连接后，可以调用 connect() 或者 connect(OnConnectCallback) 方法再次进行连接。
  - isConnected
```
public boolean isConnected()
```
    判断播放器是否已连接。
    
    返回:
    
    如果播放器已连接则返回 true，否则返回 false
  - setAutoConnect
```
public void setAutoConnect(boolean autoConnect)
```
    设置是否启用自动连接功能。
    PlayerClient 类实现了 Player 接口与 PlaylistEditor 接口。如果启用了 PlayerClient 的自动连接功能，那么在调用定义在 Player 接口与 PlaylistEditor 接口中的方法时，如果 PlayerClient 还没有连接到 PlayerService，或者连接已断开，则 PlayerClient 会尝试自动建立连接，并且会在连接成功后再去执行对应的方法。
    
    参数:
    
    autoConnect - 是否启用自动连接功能，为 true 时启用自动连接，为 false 时不启用。
    
    另请参阅:
    
    Player, PlaylistEditor
  - isAutoConnect
```
public boolean isAutoConnect()
```
    是否已经启用自动连接。
    
    返回:
    
    是否已经启用自动连接。
  - addOnConnectStateChangeListener
```
public void addOnConnectStateChangeListener(@NonNull
                                            PlayerClient.OnConnectStateChangeListener listener)
```
    添加一个监听器用来监听 PlayerClient 连接断开事件。
    
    参数:
    
    listener - 要添加的事件监听器，如果已添加，则会忽略本次调用
  - addOnConnectStateChangeListener
```
public void addOnConnectStateChangeListener(@NonNull
                                            androidx.lifecycle.LifecycleOwner owner,
                                            @NonNull
                                            PlayerClient.OnConnectStateChangeListener listener)
```
    添加一个 PlayerClient.OnConnectStateChangeListener 监听器用来监听 PlayerClient 的连接成功与断开连接事件。
    
    参数:
    
    owner - LifecycleOwner 对象。监听器会在该 LifecycleOwner 对象销毁时自动注销，避免内存泄露
    
    listener - 要添加的事件监听器，如果已添加，则会忽略本次调用
  - removeOnConnectStateChangeListener
```
public void removeOnConnectStateChangeListener(PlayerClient.OnConnectStateChangeListener listener)
```
    移除已添加的 PlayerClient.OnConnectStateChangeListener 监听器对象。
    
    参数:
    
    listener - 要移除的监听器
  - getMediaController
```
@Nullable
public android.support.v4.media.session.MediaControllerCompat getMediaController()
```
    获取 MediaControllerCompat 对象。
    
    返回:
    
    MediaControllerCompat 对象，如果还没有建立连接（isConnected() 返回 false），那么该方法可能会返回 null
  - sendCustomAction
```
public void sendCustomAction(@NonNull
                             java.lang.String action,
                             @Nullable
                             android.os.Bundle args)
```
    发送自定义动作。
    你可以通过覆盖 PlayerService.onCustomAction(String, Bundle) 方法来响应自定义动作。
    
    参数:
    
    action - 自定义动作的名称，不能为 null
    
    args - 要携带的额外参数，可为 null
  - setSoundQuality
```
public void setSoundQuality(@NonNull
                            SoundQuality soundQuality)
```
    设置播放器的首选音质（默认为 SoundQuality.STANDARD）。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    setSoundQuality 在接口中 PlayerManager
    
    参数:
    
    soundQuality - 要设置的音质，不能为 null
    
    另请参阅:
    
    SoundQuality.STANDARD, SoundQuality.LOW, SoundQuality.HIGH, SoundQuality.SUPER, getSoundQuality()
  - setAudioEffectConfig
```
public void setAudioEffectConfig(@NonNull
                                 android.os.Bundle config)
```
    修改音频特效的配置。
    
    指定者:
    
    setAudioEffectConfig 在接口中 PlayerManager
    
    参数:
    
    config - 要设置的音频特效配置，不能为 null
  - setAudioEffectEnabled
```
public void setAudioEffectEnabled(boolean enabled)
```
    设置是否启用音频特效（如：均衡器）（默认为 false）。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    setAudioEffectEnabled 在接口中 PlayerManager
    
    参数:
    
    enabled - 是否启用音频特效
    
    另请参阅:
    
    isAudioEffectEnabled()
  - setOnlyWifiNetwork
```
public void setOnlyWifiNetwork(boolean onlyWifiNetwork)
```
    设置是否只允许在 WiFi 网络下播放音乐（默认为 false）。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    setOnlyWifiNetwork 在接口中 PlayerManager
    
    参数:
    
    onlyWifiNetwork - 是否只允许在 WiFi 网络下播放音乐
    
    另请参阅:
    
    isOnlyWifiNetwork()
  - setIgnoreAudioFocus
```
public void setIgnoreAudioFocus(boolean ignoreAudioFocus)
```
    设置是否忽略音频焦点。
    
    指定者:
    
    setIgnoreAudioFocus 在接口中 PlayerManager
    
    参数:
    
    ignoreAudioFocus - 是否忽略音频焦点。如果为 true，则播放器会忽略音频焦点的获取与丢失。
  - getSoundQuality
```
public SoundQuality getSoundQuality()
```
    获取当前播放器的首选音质。
    
    另请参阅:
    
    setSoundQuality(SoundQuality)
  - getAudioEffectConfig
```
@NonNull
public android.os.Bundle getAudioEffectConfig()
```
    获取音频特效的配置。
    为了确保返回正确的值，请在连接成功后再调用该方法。
    
    返回:
    
    音频特效的配置
  - isAudioEffectEnabled
```
public boolean isAudioEffectEnabled()
```
    是否已启用音频特效。
    
    另请参阅:
    
    setAudioEffectEnabled(boolean)
  - isOnlyWifiNetwork
```
public boolean isOnlyWifiNetwork()
```
    是否只允许使用 Wifi 网络（默认为 false）。
    
    另请参阅:
    
    setOnlyWifiNetwork(boolean)
  - isIgnoreAudioFocus
```
public boolean isIgnoreAudioFocus()
```
    是否忽略音频焦点。
    
    返回:
    
    是否忽略音频焦点。
  - shutdown
```
public void shutdown()
```
    关闭播放器。
    调用该方法后，后台的播放器会自动关闭，并断开所有客户端的连接。如果客户端仅仅只需要断开与播放器的连接，使用 disconnect() 方法即可。
    
    指定者:
    
    shutdown 在接口中 PlayerManager
    
    另请参阅:
    
    disconnect()
  - getPlaylistManager
```
public PlaylistManager getPlaylistManager()
```
    获取当前 PlayerController 的 PlaylistManager 对象。
    注意！只允许在播放器已连接（isConnected() 返回 true）时，才允许使用 PlaylistManager 修改播放队列。当然，即使未连接，使用 PlaylistManager 访问播放队列还是允许的。
    
    返回:
    
    当前 PlayerController 的 PlaylistManager 对象。
  - setPlaylist
```
public void setPlaylist(@NonNull
                        Playlist playlist)
```
    设置一个新的播放列表。
    
    参数:
    
    playlist - 播放列表（不能为 null）
  - setPlaylist
```
public void setPlaylist(@NonNull
                        Playlist playlist,
                        boolean play)
```
    设置一个新的播放列表。
    
    参数:
    
    playlist - 播放列表（不能为 null）
    
    play - 是否立即播放列表中的音乐
  - setPlaylist
```
public void setPlaylist(@NonNull
                        Playlist playlist,
                        int position,
                        boolean play)
                 throws java.lang.IllegalArgumentException
```
    设置一个新的播放列表。
    
    指定者:
    
    setPlaylist 在接口中 PlaylistEditor
    
    参数:
    
    playlist - 播放列表（不能为 null）
    
    position - 播放列表中要播放的歌曲的位置
    
    play - 是否立即播放 position 参数指定处的音乐
    
    抛出:
    
    java.lang.IllegalArgumentException - 如果 position 的值小于 0，则抛出该异常
  - getPlaylist
```
public void getPlaylist(@NonNull
                        PlaylistManager.Callback callback)
```
    从接口复制的说明: PlaylistManager
    
    以异步的方式获取播放队列。
    
    指定者:
    
    getPlaylist 在接口中 PlaylistManager
  - getLastModified
```
public long getLastModified()
```
    从接口复制的说明: PlaylistManager
    
    获取最后一次修改播放列表的时间。
    这个时间是 System.currentTimeMillis()
    
    指定者:
    
    getLastModified 在接口中 PlaylistManager
    
    返回:
    
    最后一次修改播放列表的时间。
  - getPlaylistName
```
@NonNull
public java.lang.String getPlaylistName()
```
    从接口复制的说明: PlaylistManager
    
    获取播放列表的名称。
    
    指定者:
    
    getPlaylistName 在接口中 PlaylistManager
    
    返回:
    
    播放列表的名称，如果没有设置，则返回一个空字符串。
  - getPlaylistSize
```
public int getPlaylistSize()
```
    从接口复制的说明: PlaylistManager
    
    获取当前播放队列的大小。
    这是个轻量级操作，可在 UI 线程上直接运行。
    
    指定者:
    
    getPlaylistSize 在接口中 PlaylistManager
    
    返回:
    
    当前播放队列的大小。
  - getPlaylistToken
```
@NonNull
public java.lang.String getPlaylistToken()
```
    从接口复制的说明: PlaylistManager
    
    获取播放列表的 Token
    
    指定者:
    
    getPlaylistToken 在接口中 PlaylistManager
    
    返回:
    
    播放列表的 Token，如果没有设置，则返回一个空字符串。
  - isPlaylistEditable
```
public boolean isPlaylistEditable()
```
    从接口复制的说明: PlaylistManager
    
    播放列表是否是可编辑的。
    
    指定者:
    
    isPlaylistEditable 在接口中 PlaylistManager
    
    返回:
    
    播放列表是否是可编辑的，如果是可编辑的，则返回 true，否则返回 false（默认为 true）。
  - getPlayProgress
```
public int getPlayProgress()
```
    获取播放进度（单位：毫秒）。
    
    返回:
    
    播放进度
  - getPlayProgressUpdateTime
```
public long getPlayProgressUpdateTime()
```
    获取播放进度的更新时间。注意！这是基于 SystemClock.elapsedRealtime() 的时间。
    
    返回:
    
    播放进度的更新时间
  - isLooping
```
public boolean isLooping()
```
    是否单曲循环播放。
    
    返回:
    
    当播放模式为 PlayMode.LOOP 时返回 true，否则返回 false
  - getPlayingMusicItem
```
@Nullable
public MusicItem getPlayingMusicItem()
```
    获取当前正在播放的音乐。
    
    返回:
    
    当前正在播放的音乐。如果当前没有任何播放的音乐（播放列表为空，或者还没有建立连接），则返回 null
  - getPlayingMusicItemDuration
```
public int getPlayingMusicItemDuration()
```
    获取当前正在播放的音乐的持续时间。
    
    返回:
    
    当前正在播放的音乐的持续时间。如果当前没有任何播放的音乐（播放列表为空，或者还没有建立连接），则返回 0
  - getPlaybackState
```
public PlaybackState getPlaybackState()
```
    获取当前播放状态。
    
    返回:
    
    当前播放状态
    
    另请参阅:
    
    PlaybackState
  - getAudioSessionId
```
public int getAudioSessionId()
```
    获取 audio session id。
    
    返回:
    
    如果 audio session id 不可用，则返回 0
  - getBufferedProgress
```
public int getBufferedProgress()
```
    获取当前的缓存进度。
    
    返回:
    
    当前缓存进度，使用整数表示的百分比值，范围为 [0, 100]
  - isPlaying
```
public boolean isPlaying()
```
    播放器当前是否处于 PlaybackState.PLAYING 状态。
    
    返回:
    
    如果播放器当前处于 PlaybackState.PLAYING 状态则返回 true，否则返回 false
  - isStalled
```
public boolean isStalled()
```
    当前播放器是否处于 stalled 状态。
    stalled 状态用于表示当前缓冲区是否有足够的数据继续播放，如果缓冲区没有足够的数据支撑继续播放，则该方法会返回 true，如果缓冲区有足够的数据可以继续播放，则返回 false。
  - isPreparing
```
public boolean isPreparing()
```
    播放器是否正在准备中。
    
    返回:
    
    如果播放器正在准备中，则返回 true，否则返回 false
  - isPrepared
```
public boolean isPrepared()
```
    播放器是否准备完毕。
    
    返回:
    
    如果播放器已准备完毕，则返回 true，否则返回 false
  - isError
```
public boolean isError()
```
    播放器是否发生了错误。
  - getErrorCode
```
public int getErrorCode()
```
    获取错误码。
    
    返回:
    
    错误码。如果播放器没有发生错误，则返回 ErrorCode.NO_ERROR
    
    另请参阅:
    
    ErrorCode
  - getErrorMessage
```
public java.lang.String getErrorMessage()
```
    获取错误信息。
    
    返回:
    
    错误信息。该方法的返回值只在错误发生时才有意义
    
    另请参阅:
    
    isError(), getErrorCode()
  - getPlayMode
```
public PlayMode getPlayMode()
```
    获取当前播放模式。
    
    返回:
    
    当前播放模式。
  - getSpeed
```
public float getSpeed()
```
    获取播放速度。
    
    返回:
    
    播放速度。
  - getPlayPosition
```
public int getPlayPosition()
```
    获取当前播放列表的播放位置。
    
    返回:
    
    当前播放列表的播放位置
  - isSleepTimerStarted
```
public boolean isSleepTimerStarted()
```
    查询睡眠定时器是否已启动。
    
    返回:
    
    睡眠定时器是否已启动，如果已启动则返回 true，否则返回 false
  - getSleepTimerTime
```
public long getSleepTimerTime()
```
    获取睡眠定时器的定时时间。
    该方法的返回值只在睡眠定时器启动（isSleepTimerStarted() 返回 true）时才有意义。
    
    返回:
    
    睡眠定时器的定时时间。该方法的返回值只在睡眠定时器启动（isSleepTimerStarted() 返回 true）时才有意义。
  - getSleepTimerStartedTime
```
public long getSleepTimerStartedTime()
```
    获取睡眠定时器的启动时间。
    这个时间是基于 SystemClock.elapsedRealtime() 的，且该方法的返回值只在睡眠定时器启动（isSleepTimerStarted() 返回 true）时才有意义。
    使用当前的 SystemClock.elapsedRealtime() 减去这个时间，即可知道睡眠定时器已经走过的时间。
    
    返回:
    
    睡眠定时器的启动时间。该方法的返回值只在睡眠定时器启动（isSleepTimerStarted() 返回 true）时才有意义。
    
    另请参阅:
    
    getSleepTimerElapsedTime()
  - getSleepTimerElapsedTime
```
public long getSleepTimerElapsedTime()
```
    获取睡眠定时器已经走过的时间。
    该方法的返回值只在睡眠定时器启动（isSleepTimerStarted() 返回 true）时才有意义。
    
    返回:
    
    睡眠定时器已经走过的时间。
  - getTimeoutAction
```
@NonNull
public SleepTimer.TimeoutAction getTimeoutAction()
```
    获取睡眠定时器的时间到时要执行的操作。
    该方法的返回值只在睡眠定时器启动（isSleepTimerStarted() 返回 true）时才有意义。
    
    返回:
    
    睡眠定时器的时间到时要执行的操作（默认为 SleepTimer.TimeoutAction.PAUSE）
  - skipToNext
```
public void skipToNext()
```
    下一曲。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    skipToNext 在接口中 Player
  - skipToPrevious
```
public void skipToPrevious()
```
    上一曲。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    skipToPrevious 在接口中 Player
  - skipToPosition
```
public void skipToPosition(int position)
                    throws java.lang.IllegalArgumentException
```
    播放 position 处的音乐，如果播放列表中 position 处的音乐是当前正在播放的音乐，则忽略本次调用。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    skipToPosition 在接口中 Player
    
    参数:
    
    position - 要播放的音乐的 position 值（从 0 开始计算）。
    
    抛出:
    
    java.lang.IllegalArgumentException - 如果 position 值小于 0，则会抛出该异常。
  - playPause
```
public void playPause(int position)
               throws java.lang.IllegalArgumentException
```
    播放或暂停播放列表中指定索引处的音乐。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    playPause 在接口中 Player
    
    参数:
    
    position - 目标位置。
    
    抛出:
    
    java.lang.IllegalArgumentException - 如果 position 的值小于 0，则会抛出该异常。
  - setPlayMode
```
public void setPlayMode(@NonNull
                        PlayMode playMode)
```
    设置播放模式。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    setPlayMode 在接口中 Player
    
    参数:
    
    playMode - 播放模式
    
    另请参阅:
    
    PlayMode
  - setSpeed
```
public void setSpeed(float speed)
```
    设置播放速度。
    
    指定者:
    
    setSpeed 在接口中 Player
    
    参数:
    
    speed - 播放速度，最小值为 0.1，最大值为 10。
  - play
```
public void play()
```
    开始播放。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    play 在接口中 Player
  - pause
```
public void pause()
```
    暂停播放。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    pause 在接口中 Player
  - stop
```
public void stop()
```
    停止播放。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    stop 在接口中 Player
  - playPause
```
public void playPause()
```
    播放/暂停。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    playPause 在接口中 Player
  - seekTo
```
public void seekTo(int progress)
```
    调整音乐播放进度（单位：毫秒）。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    seekTo 在接口中 Player
    
    参数:
    
    progress - 要调整到的播放进度（单位：毫秒）
  - isForbidSeek
```
public boolean isForbidSeek()
```
    判断是否禁用了所有的 seek 操作。
    默认为 false，如果该方法返回 true，则会同时禁用 seekTo、fastForward、rewind 操作。
    
    返回:
    
    是否禁用了所有的 seek 操作
  - fastForward
```
public void fastForward()
```
    快进。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    fastForward 在接口中 Player
  - rewind
```
public void rewind()
```
    快退。
    该方法只在连接到播放器后（isConnected() 返回 true）才有效。
    
    指定者:
    
    rewind 在接口中 Player
  - startSleepTimer
```
public void startSleepTimer(long time)
                     throws java.lang.IllegalArgumentException
```
    启动睡眠定时器。
    
    参数:
    
    time - 睡眠时间（单位：毫秒）。播放器会在经过 time 时间后暂停播放。
    
    抛出:
    
    java.lang.IllegalArgumentException - 如果定时时间小于 0，则抛出该异常
  - startSleepTimer
```
public void startSleepTimer(long time,
                            @NonNull
                            SleepTimer.TimeoutAction action)
                     throws java.lang.IllegalArgumentException
```
    启动睡眠定时器。
    
    指定者:
    
    startSleepTimer 在接口中 SleepTimer
    
    参数:
    
    time - 睡眠时间（单位：毫秒）。播放器会在经过 time 时间后暂停播放。
    
    action - 定时器的的时间到时要执行的操作。
    
    抛出:
    
    java.lang.IllegalArgumentException - 如果定时时间小于 0，则抛出该异常
  - cancelSleepTimer
```
public void cancelSleepTimer()
```
    取消睡眠定时器。
    
    指定者:
    
    cancelSleepTimer 在接口中 SleepTimer
  - addOnPlaybackStateChangeListener
```
public void addOnPlaybackStateChangeListener(@NonNull
                                             Player.OnPlaybackStateChangeListener listener)
```
    添加一个播放器播放状态监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 播放器播放状态监听器
    
    另请参阅:
    
    Player.OnPlaybackStateChangeListener
  - addOnPlaybackStateChangeListener
```
public void addOnPlaybackStateChangeListener(@NonNull
                                             androidx.lifecycle.LifecycleOwner owner,
                                             @NonNull
                                             Player.OnPlaybackStateChangeListener listener)
```
    添加一个播放器播放状态监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    owner - LifecycleOwner 对象
    
    listener - 播放器播放状态监听器
    
    另请参阅:
    
    Player.OnPlaybackStateChangeListener
  - removeOnPlaybackStateChangeListener
```
public void removeOnPlaybackStateChangeListener(Player.OnPlaybackStateChangeListener listener)
```
    移除播放器播放状态监听器。
    
    参数:
    
    listener - 要移除的监听器。
  - addOnPrepareListener
```
public void addOnPrepareListener(@NonNull
                                 Player.OnPrepareListener listener)
```
    添加一个播放器准备（prepare）状态监听器。
    
    参数:
    
    listener - 如果监听器已存在，则忽略本次添加
  - addOnPrepareListener
```
public void addOnPrepareListener(@NonNull
                                 androidx.lifecycle.LifecycleOwner owner,
                                 @NonNull
                                 Player.OnPrepareListener listener)
```
    添加一个播放器准备（prepare）状态监听器。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    owner - LifecycleOwner 对象
    
    listener - 如果监听器已存在，则忽略本次添加
  - removeOnPrepareListener
```
public void removeOnPrepareListener(Player.OnPrepareListener listener)
```
    移除一个播放器准备（prepare）状态监听器。
    
    参数:
    
    listener - 要移除的监听器
  - addOnStalledChangeListener
```
public void addOnStalledChangeListener(@NonNull
                                       Player.OnStalledChangeListener listener)
```
    添加一个 stalled 状态监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnStalledChangeListener
  - addOnStalledChangeListener
```
public void addOnStalledChangeListener(@NonNull
                                       androidx.lifecycle.LifecycleOwner owner,
                                       @NonNull
                                       Player.OnStalledChangeListener listener)
```
    添加一个 stalled 状态监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnStalledChangeListener
  - removeOnStalledChangeListener
```
public void removeOnStalledChangeListener(Player.OnStalledChangeListener listener)
```
    移除 stalled 状态监听器。
    
    参数:
    
    listener - 要移除的监听器。
  - addOnBufferedProgressChangeListener
```
public void addOnBufferedProgressChangeListener(@NonNull
                                                Player.OnBufferedProgressChangeListener listener)
```
    添加一个缓存进度监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnBufferedProgressChangeListener
  - addOnBufferedProgressChangeListener
```
public void addOnBufferedProgressChangeListener(@NonNull
                                                androidx.lifecycle.LifecycleOwner owner,
                                                @NonNull
                                                Player.OnBufferedProgressChangeListener listener)
```
    添加一个缓存进度监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    owner - LifecycleOwner 对象
    
    listener - 要添加的监听器
  - removeOnBufferedProgressChangeListener
```
public void removeOnBufferedProgressChangeListener(Player.OnBufferedProgressChangeListener listener)
```
    移除缓存进度监听器。
    
    参数:
    
    listener - 要移除的监听器
  - addOnPlayingMusicItemChangeListener
```
public void addOnPlayingMusicItemChangeListener(@NonNull
                                                Player.OnPlayingMusicItemChangeListener listener)
```
    添加一个监听当前播放的 MusicItem 改变事件的监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnPlayingMusicItemChangeListener
  - addOnPlayingMusicItemChangeListener
```
public void addOnPlayingMusicItemChangeListener(@NonNull
                                                androidx.lifecycle.LifecycleOwner owner,
                                                @NonNull
                                                Player.OnPlayingMusicItemChangeListener listener)
```
    添加一个监听当前播放的 MusicItem 改变事件的监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnPlayingMusicItemChangeListener
  - removeOnPlayingMusicItemChangeListener
```
public void removeOnPlayingMusicItemChangeListener(Player.OnPlayingMusicItemChangeListener listener)
```
    移除当前播放的 MusicItem 改变事件监听器
    
    参数:
    
    listener - 要移除的监听器
  - addOnSeekCompleteListener
```
public void addOnSeekCompleteListener(@NonNull
                                      Player.OnSeekCompleteListener listener)
```
    添加一个用于监听播放器播放进度调整完毕事件的监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnSeekCompleteListener
  - addOnSeekCompleteListener
```
public void addOnSeekCompleteListener(@NonNull
                                      androidx.lifecycle.LifecycleOwner owner,
                                      @NonNull
                                      Player.OnSeekCompleteListener listener)
```
    添加一个用于监听播放器播放进度调整完毕事件的监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnSeekCompleteListener
  - removeOnSeekCompleteListener
```
public void removeOnSeekCompleteListener(Player.OnSeekCompleteListener listener)
```
    移除用于监听播放器播放进度调整完毕的监听器。
    
    参数:
    
    listener - 要移除的监听器
  - addOnPlaylistChangeListener
```
public void addOnPlaylistChangeListener(@NonNull
                                        Player.OnPlaylistChangeListener listener)
```
    添加一个用于监听播放列表改变事件的监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnPlaylistChangeListener
  - addOnPlaylistChangeListener
```
public void addOnPlaylistChangeListener(@NonNull
                                        androidx.lifecycle.LifecycleOwner owner,
                                        @NonNull
                                        Player.OnPlaylistChangeListener listener)
```
    添加一个用于监听播放列表改变事件的监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnPlaylistChangeListener
  - removeOnPlaylistChangeListener
```
public void removeOnPlaylistChangeListener(Player.OnPlaylistChangeListener listener)
```
    移除用于监听播放列表改变事件的监听器。
    
    参数:
    
    listener - 要移除的监听器
  - addOnPlayModeChangeListener
```
public void addOnPlayModeChangeListener(@NonNull
                                        Player.OnPlayModeChangeListener listener)
```
    添加一个用于监听播放模式改变的监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnPlayModeChangeListener
  - addOnPlayModeChangeListener
```
public void addOnPlayModeChangeListener(@NonNull
                                        androidx.lifecycle.LifecycleOwner owner,
                                        @NonNull
                                        Player.OnPlayModeChangeListener listener)
```
    添加一个用于监听播放模式改变的监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
    
    另请参阅:
    
    Player.OnPlayModeChangeListener
  - removeOnPlayModeChangeListener
```
public void removeOnPlayModeChangeListener(Player.OnPlayModeChangeListener listener)
```
    移除一个用于监听播放模式改变的监听器。
    
    参数:
    
    listener - 要移除的事件监听器
  - addOnSpeedChangeListener
```
public void addOnSpeedChangeListener(@NonNull
                                     Player.OnSpeedChangeListener listener)
```
    添加一个用于监听播放速度改变的监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器，不能为 null
  - addOnSpeedChangeListener
```
public void addOnSpeedChangeListener(@NonNull
                                     androidx.lifecycle.LifecycleOwner owner,
                                     @NonNull
                                     Player.OnSpeedChangeListener listener)
```
    添加一个用于监听播放速度改变的监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器，不能为 null
  - removeOnSpeedChangeListener
```
public void removeOnSpeedChangeListener(Player.OnSpeedChangeListener listener)
```
    移除一个用于监听播放模式改变的监听器。
    
    参数:
    
    listener - 要移除的事件监听器
  - addOnPlaybackStateChangeListener
```
public void addOnPlaybackStateChangeListener(@NonNull
                                             PlayerClient.OnPlaybackStateChangeListener listener)
```
    监听播放器状态。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
  - addOnPlaybackStateChangeListener
```
public void addOnPlaybackStateChangeListener(@NonNull
                                             androidx.lifecycle.LifecycleOwner owner,
                                             @NonNull
                                             PlayerClient.OnPlaybackStateChangeListener listener)
```
    监听播放器状态。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
  - removeOnPlaybackStateChangeListener
```
public void removeOnPlaybackStateChangeListener(PlayerClient.OnPlaybackStateChangeListener listener)
```
    移除播放器状态监听器。
    
    参数:
    
    listener - 要移除的监听器
  - addOnAudioSessionChangeListener
```
public void addOnAudioSessionChangeListener(@NonNull
                                            PlayerClient.OnAudioSessionChangeListener listener)
```
    添加一个 audio session id 监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
  - addOnAudioSessionChangeListener
```
public void addOnAudioSessionChangeListener(@NonNull
                                            androidx.lifecycle.LifecycleOwner owner,
                                            @NonNull
                                            PlayerClient.OnAudioSessionChangeListener listener)
```
    监听播放器的 audio session id
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
  - removeOnAudioSessionChangeListener
```
public void removeOnAudioSessionChangeListener(PlayerClient.OnAudioSessionChangeListener listener)
```
    移除 audio session id 监听器。
    
    参数:
    
    listener - 要移除的监听器
  - addOnSleepTimerStateChangeListener
```
public void addOnSleepTimerStateChangeListener(@NonNull
                                               SleepTimer.OnStateChangeListener listener)
```
    监听睡眠定时器的状态。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器
  - addOnSleepTimerStateChangeListener
```
public void addOnSleepTimerStateChangeListener(@NonNull
                                               androidx.lifecycle.LifecycleOwner owner,
                                               @NonNull
                                               SleepTimer.OnStateChangeListener listener)
```
    监听睡眠定时器的状态。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器
  - removeOnSleepTimerStateChangeListener
```
public void removeOnSleepTimerStateChangeListener(SleepTimer.OnStateChangeListener listener)
```
    移除已注册的睡眠定时器状态监听器。
    
    参数:
    
    listener - 要移除的监听器
  - addOnRepeatListener
```
public void addOnRepeatListener(@NonNull
                                Player.OnRepeatListener listener)
```
    添加一个 Player.OnRepeatListener 监听器。
    如果监听器已添加，则忽略本次调用。
    
    参数:
    
    listener - 要添加的监听器，不能为 null
  - addOnRepeatListener
```
public void addOnRepeatListener(@NonNull
                                androidx.lifecycle.LifecycleOwner owner,
                                @NonNull
                                Player.OnRepeatListener listener)
```
    添加一个 Player.OnRepeatListener 监听器。
    如果监听器已添加，则忽略本次调用。
    事件监听器会在 LifecycleOwner 销毁时自动注销，以避免发生内容泄露。
    
    参数:
    
    listener - 要添加的监听器，不能为 null
  - removeOnRepeatListener
```
public void removeOnRepeatListener(Player.OnRepeatListener listener)
```
    异常已注册的 Player.OnRepeatListener 监听器。
  - insertMusicItem
```
public void insertMusicItem(int position,
                            @NonNull
                            MusicItem musicItem)
                     throws java.lang.IllegalArgumentException
```
    往列表中插入了一首新的歌曲。
    如果播放列表中已包含指定歌曲，则会将它移动到 position 位置，如果不存在，则会将歌曲插入到 position 位置。
    
    指定者:
    
    insertMusicItem 在接口中 PlaylistEditor
    
    参数:
    
    position - 歌曲插入的位置
    
    musicItem - 要插入的歌曲，不能为 null
    
    抛出:
    
    java.lang.IllegalArgumentException - 如果 position 的值小于 0，则抛出该异常
  - appendMusicItem
```
public void appendMusicItem(@NonNull
                            MusicItem musicItem)
```
    从接口复制的说明: PlaylistEditor
    
    往播放列表的末尾添加一首歌曲。
    如果播放列表中已包含指定歌曲，则会将它移动到播放列表的末尾位置，如果不存在，则会将歌曲添加到播放列表的末尾。
    
    指定者:
    
    appendMusicItem 在接口中 PlaylistEditor
    
    参数:
    
    musicItem - 要添加播放列表末尾的歌曲，不能为 null
  - moveMusicItem
```
public void moveMusicItem(int fromPosition,
                          int toPosition)
                   throws java.lang.IndexOutOfBoundsException
```
    移动播放列表中某首歌曲的位置。
    
    指定者:
    
    moveMusicItem 在接口中 PlaylistEditor
    
    参数:
    
    fromPosition - 歌曲在列表中的位置
    
    toPosition - 歌曲要移动到的位置。如果 toPosition == fromPosition，则会忽略本次调用
    
    抛出:
    
    java.lang.IndexOutOfBoundsException - 如果 fromPosition 或者 toPosition 超出播放列表索引的范围，则抛出该异常
  - removeMusicItem
```
public void removeMusicItem(@NonNull
                            MusicItem musicItem)
```
    从接口复制的说明: PlaylistEditor
    
    从播放列表中移除了指定歌曲。
    
    指定者:
    
    removeMusicItem 在接口中 PlaylistEditor
    
    参数:
    
    musicItem - 要移除的歌曲。如果播放列表中不包含该歌曲，则忽略本次调用
  - removeMusicItem
```
public void removeMusicItem(int position)
```
    从接口复制的说明: PlaylistEditor
    
    移除播放列表中指定位置的歌曲。
    
    指定者:
    
    removeMusicItem 在接口中 PlaylistEditor
    
    参数:
    
    position - 要移除的歌曲的位置
  - setNextPlay
```
public void setNextPlay(@NonNull
                        MusicItem musicItem)
```
    从接口复制的说明: PlaylistEditor
    
    设置 “下一次播放” 的歌曲。
    
    指定者:
    
    setNextPlay 在接口中 PlaylistEditor
    
    参数:
    
    musicItem - 要设定为 “下一次播放” 的歌曲，如果歌曲已存在播放列表中，则会移动到 “下一曲播放” 的位置，如果歌曲不存在，则插入到 “下一曲播放” 位置

类 PlayerClient

嵌套类概要

从接口继承的嵌套类/接口 snow.player.Player

从接口继承的嵌套类/接口 snow.player.playlist.PlaylistManager

从接口继承的嵌套类/接口 snow.player.SleepTimer

方法概要

从类继承的方法 java.lang.Object

方法详细资料

newInstance

connect

connect

disconnect

isConnected

setAutoConnect

isAutoConnect

addOnConnectStateChangeListener

addOnConnectStateChangeListener

removeOnConnectStateChangeListener

getMediaController

sendCustomAction

setSoundQuality

setAudioEffectConfig

setAudioEffectEnabled

setOnlyWifiNetwork

setIgnoreAudioFocus

getSoundQuality

getAudioEffectConfig

isAudioEffectEnabled

isOnlyWifiNetwork

isIgnoreAudioFocus

shutdown

getPlaylistManager

setPlaylist

setPlaylist

setPlaylist

getPlaylist

getLastModified

getPlaylistName

getPlaylistSize

getPlaylistToken

isPlaylistEditable

getPlayProgress

getPlayProgressUpdateTime

isLooping

getPlayingMusicItem

getPlayingMusicItemDuration

getPlaybackState

getAudioSessionId

getBufferedProgress

isPlaying

isStalled

isPreparing

isPrepared

isError

getErrorCode

getErrorMessage

getPlayMode

getSpeed

getPlayPosition

isSleepTimerStarted

getSleepTimerTime

getSleepTimerStartedTime

getSleepTimerElapsedTime

getTimeoutAction

skipToNext

skipToPrevious

skipToPosition

playPause

setPlayMode

setSpeed

play

pause

stop

playPause

seekTo

isForbidSeek

fastForward

rewind

startSleepTimer

startSleepTimer