snow.player.appwidget

类 AppWidgetPlayerState

java.lang.Object

snow.player.appwidget.AppWidgetPlayerState

所有已实现的接口:

android.os.Parcelable

public class AppWidgetPlayerState
extends java.lang.Object
implements android.os.Parcelable

该类主要用于在 AppWidget 中访问播放器状态。

当播放器状态改变时，会发送一个 ACTION_PLAYER_STATE_CHANGED 广播，该广播的 Category 是你的 PlayerService 的完整类名（如 snow.player.demo.MyPlayerService）。可以为你的 AppWidgetProvider 添加一个监听该广播的 <intent-filter>，并在接收到该广播时更新你的 AppWidget。

例：

 <receiver android:name=".MyAppWidgetProvider">
      ...
      <intent-filter>
          <action android:name="snow.player.appwidget.action.PLAYER_STATE_CHANGED" />
          <category android:name="snow.player.demo.MyPlayerService"/>
      </intent-filter>
 </receiver>
 

嵌套类概要

从接口继承的嵌套类/接口 android.os.Parcelable

android.os.Parcelable.ClassLoaderCreator<T>, android.os.Parcelable.Creator<T>

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ACTION_PLAYER_STATE_CHANGED
static android.os.Parcelable.Creator<AppWidgetPlayerState>	CREATOR

从接口继承的字段 android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

构造器概要

构造器

限定符	构造器和说明
protected	AppWidgetPlayerState(android.os.Parcel in)
	AppWidgetPlayerState(PlaybackState playbackState, MusicItem playingMusicItem, PlayMode playMode, float speed, long playProgress, long playProgressUpdateTime, boolean preparing, boolean prepared, boolean stalled, java.lang.String errorMessage)

方法概要

限定符和类型	方法和说明
int	describeContents()
static AppWidgetPlayerState	emptyState()
java.lang.String	getErrorMessage()
PlaybackState	getPlaybackState()
static AppWidgetPlayerState	getPlayerState(android.content.Context context, java.lang.Class<? extends PlayerService> playerService)
MusicItem	getPlayingMusicItem()
PlayMode	getPlayMode()
long	getPlayProgress()
long	getPlayProgressUpdateTime()
float	getSpeed()
boolean	isPrepared()
boolean	isPreparing()
static boolean	isServiceAlive(android.content.Context context, java.lang.Class<? extends PlayerService> playerService) 检查 PlayerService 是否存活。
boolean	isStalled()
static void	updatePlayerState(android.content.Context context, java.lang.Class<? extends PlayerService> playerService, AppWidgetPlayerState playerState)
void	writeToParcel(android.os.Parcel dest, int flags)

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

ACTION_PLAYER_STATE_CHANGED

public static final java.lang.String ACTION_PLAYER_STATE_CHANGED

另请参阅:

常量字段值

CREATOR

public static final android.os.Parcelable.Creator<AppWidgetPlayerState> CREATOR

构造器详细资料

AppWidgetPlayerState

public AppWidgetPlayerState(@NonNull
                            PlaybackState playbackState,
                            @Nullable
                            MusicItem playingMusicItem,
                            @NonNull
                            PlayMode playMode,
                            float speed,
                            long playProgress,
                            long playProgressUpdateTime,
                            boolean preparing,
                            boolean prepared,
                            boolean stalled,
                            @NonNull
                            java.lang.String errorMessage)

AppWidgetPlayerState

protected AppWidgetPlayerState(android.os.Parcel in)

方法详细资料

emptyState

public static AppWidgetPlayerState emptyState()

getPlayerState

public static AppWidgetPlayerState getPlayerState(@NonNull
                                                  android.content.Context context,
                                                  @NonNull
                                                  java.lang.Class<? extends PlayerService> playerService)

updatePlayerState

public static void updatePlayerState(@NonNull
                                     android.content.Context context,
                                     @NonNull
                                     java.lang.Class<? extends PlayerService> playerService,
                                     @NonNull
                                     AppWidgetPlayerState playerState)

getPlaybackState

@NonNull
public PlaybackState getPlaybackState()

getPlayingMusicItem

@Nullable
public MusicItem getPlayingMusicItem()

getPlayMode

@NonNull
public PlayMode getPlayMode()

getSpeed

public float getSpeed()

getPlayProgress

public long getPlayProgress()

getPlayProgressUpdateTime

public long getPlayProgressUpdateTime()

isPreparing

public boolean isPreparing()

isPrepared

public boolean isPrepared()

isStalled

public boolean isStalled()

getErrorMessage

@NonNull
public java.lang.String getErrorMessage()

isServiceAlive

public static boolean isServiceAlive(android.content.Context context,
                                     java.lang.Class<? extends PlayerService> playerService)

检查 PlayerService 是否存活。

返回:

如果 PlayerService 处于存活状态，则返回 true，否则返回 false

writeToParcel

public void writeToParcel(android.os.Parcel dest,
                          int flags)

指定者:

writeToParcel 在接口中 android.os.Parcelable

describeContents

public int describeContents()

指定者:

describeContents 在接口中 android.os.Parcelable