Summary: Constants | Ctors | Inherited Methods | [Expand All]

MediaControlConstants

public class MediaControlConstants
extends Object

java.lang.Object
   ↳ android.support.wearable.media.MediaControlConstants

自定义Wear上显示的媒体控件的常量。

这些常量定义了可以添加到 MediaSession或会话中的自定义操作的额外功能，以定制Wear上相关媒体控件的外观和功能。

这些附加内容可以添加到伴侣设备上的会话（以自动影响Wear上显示的媒体控件）或在可穿戴设备上创建的会话（以影响应用创建 Notification.MediaStyle通知时显示的媒体控件）。

例如，要创建将出现在Wear上的自定义操作：

PlaybackState.CustomAction.Builder actionBuilder =
         new PlaybackState.CustomAction.Builder(action, name, icon);
 Bundle actionExtras = new Bundle();
 actionExtras.putBoolean(MediaControlConstants.EXTRA_CUSTOM_ACTION_SHOW_ON_WEAR, true);
 actionBuilder.setExtras(actionExtras);

除非四路控件上有空格，否则该自定义操作将在标准媒体控件之后显示为通知式操作，因为不支持skip-next或skip-previous。

如果您不希望自定义操作出现在四向控件上，则可以将这些控件的左右空格保留为skip-previous和skip-next，只需在该会话中设置会话的附加内容即可：

Bundle sessionExtras = new Bundle();
 sessionExtras.putBoolean(MediaControlConstants.EXTRA_RESERVE_SLOT_SKIP_TO_PREVIOUS, true);
 sessionExtras.putBoolean(MediaControlConstants.EXTRA_RESERVE_SLOT_SKIP_TO_NEXT, true);
 mediaSession.setExtras(sessionExtras);

Summary

Constants
String EXTRA_BACKGROUND_COLOR_FROM_THEME

可以添加到 MediaSession的布尔额外键，以使Wear上的关联媒体控件的背景颜色来自指定主题。
String EXTRA_CUSTOM_ACTION_SHOW_ON_WEAR

可以添加到 PlaybackState.CustomAction以允许将操作添加到Wear上的媒体控件的布尔额外键。
String EXTRA_RESERVE_SLOT_SKIP_TO_NEXT

可以添加到 MediaSession以确保用于跳转到下一个动作的四向控件上使用的空间不用于自定义动作的布尔额外键。
String EXTRA_RESERVE_SLOT_SKIP_TO_PREVIOUS

可以添加到 MediaSession以确保用于跳转到上一个操作的四向控件上使用的空间不用于自定义操作的布尔额外键。

Public constructors
MediaControlConstants()

Inherited methods
From class java.lang.Object

Constants

EXTRA_BACKGROUND_COLOR_FROM_THEME

String EXTRA_BACKGROUND_COLOR_FROM_THEME

可以添加到 MediaSession的布尔额外键，以使指定主题中Wear的相关媒体控件的背景颜色 MediaSession 。

如果需要特定主题，则可以在创建MediaSession的应用的清单中指定一个名称为com.google.android.wearable.media.theme的元数据项。 否则，将使用应用程序主题。

例如，可以将以下内容添加到应用程序的清单中，以使用媒体控件的特定主题：

 <meta-data android:name="com.google.android.wearable.media.theme"
         android:resource="@style/MediaTheme"/>

对于给定的主题，使用的颜色将是 colorPrimaryDark 。

如果此额外内容不存在或具有非真实值，则媒体控件的颜色将来自专辑封面。

常量值：“android.support.wearable.media.extra.BACKGROUND_COLOR_FROM_THEME”

EXTRA_CUSTOM_ACTION_SHOW_ON_WEAR

String EXTRA_CUSTOM_ACTION_SHOW_ON_WEAR

可以添加到 PlaybackState.CustomAction以允许将操作添加到Wear上的媒体控件的布尔额外键。

具有此额外功能的自定义操作将按照它们在PlaybackState中定义的顺序添加到控件中。 第一个这样的操作将占用四路控制器上的左侧空间，除非会话支持ACTION_SKIP_TO_PREVIOUS 。 除非会话支持ACTION_SKIP_TO_NEXT ，否则可用于自定义操作的下一个空间是四向控件上的正确空间。 任何在四向控件上找不到空格的自定义操作都将作为通知样式操作添加到四向控件之后。

为确保四向控件上的左侧或右侧空间不会被自定义操作占用，即使不支持跳过下一个或跳过上一个，请使用 EXTRA_RESERVE_SLOT_SKIP_TO_PREVIOUS或 EXTRA_RESERVE_SLOT_SKIP_TO_NEXT 。

常量值：“android.support.wearable.media.extra.CUSTOM_ACTION_SHOW_ON_WEAR”

EXTRA_RESERVE_SLOT_SKIP_TO_NEXT

String EXTRA_RESERVE_SLOT_SKIP_TO_NEXT

可以添加到 MediaSession的布尔额外键，以确保用于跳转到下一个动作的四向控件上使用的空间不用于自定义动作。

如果跳过下一个动作仅暂时不可用，例如如果当前曲目是播放列表中的最后一个，这可能是有用的。

也可以看看：

常量值：“android.support.wearable.media.extra.RESERVE_SLOT_SKIP_TO_NEXT”

EXTRA_RESERVE_SLOT_SKIP_TO_PREVIOUS

String EXTRA_RESERVE_SLOT_SKIP_TO_PREVIOUS

可以添加到 MediaSession的布尔额外键，以确保用于跳转到上一个操作的四向控件上使用的空间不用于自定义操作。

如果跳过上一个动作仅暂时不可用，例如，如果当前曲目是播放列表中的第一个，这可能很有用。

也可以看看：

常量值：“android.support.wearable.media.extra.RESERVE_SLOT_SKIP_TO_PREVIOUS”

Public constructors

MediaControlConstants

MediaControlConstants ()