Most visited

Recently visited

Results for

Added in API level 17

DreamService

public class DreamService
extends Service implements Window.Callback

java.lang.Object
	android.content.Context
		android.content.ContextWrapper
			android.app.Service
				android.service.dreams.DreamService

扩展此类以实现自定义梦想（作为“Daydream”提供给用户）。

梦想是在充电设备闲置或停靠在桌子底座上时启动的交互式屏幕保护程序。梦想为应用程序表达自己提供了另一种形式，专为展览/精益体验而量身定制。

DreamService生命周期如下所示：

onAttachedToWindow()
将其用于初始设置，例如调用 setContentView() 。
onDreamingStarted()
你的梦想已经开始，所以你应该在这里开始动画或其他行为。
onDreamingStopped()
用这个来停止你在 onDreamingStarted()开始的东西。
onDetachedFromWindow()
使用它来拆除资源（例如，分离处理程序和监听程序）。

另外，onCreate和onDestroy（来自Service接口）也将被调用，但是初始化和拆卸应该通过覆盖上面的钩子来完成。

为了使系统可用，应在清单中声明您的 DreamService ，如下所示：

 <service
     android:name=".MyDream"
     android:exported="true"
     android:icon="@drawable/my_icon"
     android:label="@string/my_dream_label" >

     <intent-filter>
         <action android:name="android.service.dreams.DreamService" />
         <category android:name="android.intent.category.DEFAULT" />
     </intent-filter>

     <!-- Point to additional information for this dream (optional) -->
     <meta-data
         android:name="android.service.dream"
         android:resource="@xml/my_dream" />
 </service>

如果使用<meta-data>元素指定，则使用单独的XML文件中的<dream>元素定义梦想的其他信息。目前，您可以提供的唯一附加信息是允许用户配置梦想行为的设置活动。例如：

RES / XML / my_dream.xml

 <dream xmlns:android="http://schemas.android.com/apk/res/android"
     android:settingsActivity="com.example.app/.MyDreamSettingsActivity" />

这使得设置按钮可以在系统设置中的梦想列表旁边使用，当按下按钮打开指定的活动时。

要指定您的梦想布局，请拨打setContentView(View) ，通常在onAttachedToWindow()回拨期间。例如：

 public class MyDream extends DreamService {

     @Override
     public void onAttachedToWindow() {
         super.onAttachedToWindow();

         // Exit dream upon user touch
         setInteractive(false);
         // Hide system UI
         setFullscreen(true);
         // Set the dream layout
         setContentView(R.layout.dream);
     }
 }

当针对api level 21及以上版本时，您必须在清单文件中声明服务并具有BIND_DREAM_SERVICE权限。例如：

 <service
     android:name=".MyDream"
     android:exported="true"
     android:icon="@drawable/my_icon"
     android:label="@string/my_dream_label"
     android:permission="android.permission.BIND_DREAM_SERVICE">
   <intent-filter>
     <action android:name=”android.service.dreams.DreamService” />
     <category android:name=”android.intent.category.DEFAULT” />
   </intent-filter>
 </service>

摘要(Summary)

常量(Constants)
`String`	`DREAM_META_DATA` Dream发布自己的信息的名称。
`String`	`SERVICE_INTERFACE` 必须声明为由服务处理的 `Intent` 。

Inherited constants

From class android.app.Service

From class android.content.Context

From interface android.content.ComponentCallbacks2

Public constructors
`DreamService()`

公共方法(Public methods)
`void`	`addContentView(View view, ViewGroup.LayoutParams params)` 将视图添加到Dream的窗口，留下其他内容视图。
`boolean`	`dispatchGenericMotionEvent(MotionEvent event)` 被调用来处理通用运动事件。
`boolean`	`dispatchKeyEvent(KeyEvent event)` 被调用来处理关键事件。
`boolean`	`dispatchKeyShortcutEvent(KeyEvent event)` 被调用来处理键快捷键事件。
`boolean`	`dispatchPopulateAccessibilityEvent(AccessibilityEvent event)` 打电话来处理 `AccessibilityEvent`的人口。
`boolean`	`dispatchTouchEvent(MotionEvent event)` 被调用来处理触摸屏事件。
`boolean`	`dispatchTrackballEvent(MotionEvent event)` 被称为处理轨迹球事件。
`View`	`findViewById(int id)` 查找由 `onCreate()`中处理的XML中的id属性标识的视图。
`final void`	`finish()` 停止梦想并脱离窗口。
`Window`	`getWindow()` 为梦想检索当前 `Window` 。
`WindowManager`	`getWindowManager()` 检索当前 `WindowManager`的梦想。
`boolean`	`isFullscreen()` 返回此梦是否处于全屏模式。
`boolean`	`isInteractive()` 返回这个梦是否是互动的。
`boolean`	`isScreenBright()` 返回这个梦是否在梦中保持屏幕亮度。
`void`	`onActionModeFinished(ActionMode mode)` 当动作模式完成时调用。
`void`	`onActionModeStarted(ActionMode mode)` 当动作模式已启动时调用。
`void`	`onAttachedToWindow()` 当窗口已连接到窗口管理器时调用。
`final IBinder`	`onBind(Intent intent)` 将通信信道返回给服务。
`void`	`onContentChanged()` 只要屏幕的内容视图发生更改（由于致电 `Window.setContentView`或 `Window.addContentView` ）， `Window.setContentView`调用此挂钩。
`void`	`onCreate()` 当这个梦被构建时调用。
`boolean`	`onCreatePanelMenu(int featureId, Menu menu)` 初始化面板'featureId'的菜单内容。
`View`	`onCreatePanelView(int featureId)` 实例化视图以显示在“featureId”的面板中。
`void`	`onDestroy()` 由系统调用以通知服务它已不再使用并正在被删除。
`void`	`onDetachedFromWindow()` 当窗口已连接到窗口管理器时调用。
`void`	`onDreamingStarted()` 当梦的窗口已经创建并且可见并且动画现在可以开始时调用。
`void`	`onDreamingStopped()` 当窗口被移除之前，当这个梦被停止时，通过外部请求或调用finish（）来调用。
`boolean`	`onMenuItemSelected(int featureId, MenuItem item)` 当用户选择了面板的菜单项时调用。
`boolean`	`onMenuOpened(int featureId, Menu menu)` 用户打开面板菜单时调用。
`void`	`onPanelClosed(int featureId, Menu menu)` 当面板关闭时调用。
`boolean`	`onPreparePanel(int featureId, View view, Menu menu)` 准备要显示的面板。
`boolean`	`onSearchRequested()` 当用户指示开始搜索的愿望时调用。
`boolean`	`onSearchRequested(SearchEvent event)` 当用户指示开始搜索的愿望时调用。
`void`	`onWakeUp()` 当梦想被要求停止并唤醒时调用。
`void`	`onWindowAttributesChanged(WindowManager.LayoutParams attrs)` 这在每当当前窗口属性改变时被调用。
`void`	`onWindowFocusChanged(boolean hasFocus)` 这个钩子在窗口焦点改变时被调用。
`ActionMode`	`onWindowStartingActionMode(ActionMode.Callback callback)` 当此窗口的动作模式正在启动时调用。
`ActionMode`	`onWindowStartingActionMode(ActionMode.Callback callback, int type)` 当此窗口的动作模式正在启动时调用。
`void`	`setContentView(View view)` 将视图设置为此Dream的内容视图。
`void`	`setContentView(int layoutResID)` 使布局资源膨胀并将其设置为此Dream的内容视图。
`void`	`setContentView(View view, ViewGroup.LayoutParams params)` 将视图设置为此Dream的内容视图。
`void`	`setFullscreen(boolean fullscreen)` 在梦想窗口上控制 `FLAG_FULLSCREEN` 。
`void`	`setInteractive(boolean interactive)` 将此梦想标记为交互式以接收输入事件。
`void`	`setScreenBright(boolean screenBright)` 将这个梦想标志为在梦中保持屏幕亮度。
`final void`	`wakeUp()` 轻轻唤醒梦。

Protected methods
`void`	`dump(FileDescriptor fd, PrintWriter pw, String[] args)` 将服务的状态打印到给定的流中。

继承方法(Inherited methods)

From class android.app.Service

`void`	`dump(FileDescriptor fd, PrintWriter writer, String[] args)` 将服务的状态打印到给定的流中。
`final Application`	`getApplication()` 返回拥有此服务的应用程序。
`abstract IBinder`	`onBind(Intent intent)` 将通信信道返回给服务。
`void`	`onConfigurationChanged(Configuration newConfig)` 设备配置在组件运行时发生更改时由系统调用。
`void`	`onCreate()` 服务第一次创建时由系统调用。
`void`	`onDestroy()` 由系统调用以通知服务它已不再使用并正在被删除。
`void`	`onLowMemory()` 这在整个系统内存不足时调用，并且主动运行的进程应该修剪内存使用情况。
`void`	`onRebind(Intent intent)` 当新客户连接到服务时调用，之前它已被通知所有已断开连接的 `onUnbind(Intent)` 。
`void`	`onStart(Intent intent, int startId)` 此方法在API级别5中已弃用。 `onStartCommand(Intent, int, int)`改为执行`onStartCommand(Intent, int, int)` 。
`int`	`onStartCommand(Intent intent, int flags, int startId)` 每次客户端通过调用 `startService(Intent)`显式启动服务时，由系统调用，提供它提供的参数以及代表启动请求的唯一整数标记。
`void`	`onTaskRemoved(Intent rootIntent)` 如果服务当前正在运行并且用户已经删除了来自服务应用程序的任务，则会调用该服务。
`void`	`onTrimMemory(int level)` 当操作系统确定进程从其进程中删除不需要的内存是一个好时机时调用。
`boolean`	`onUnbind(Intent intent)` 当所有客户端与服务发布的特定接口断开连接时调用。
`final void`	`startForeground(int id, Notification notification)` 使该服务在前台运行，提供正在进行的通知，以便在此状态下向用户显示。
`final void`	`stopForeground(int flags)` 从前台状态中删除此服务，如果需要更多内存，则允许它被终止。
`final void`	`stopForeground(boolean removeNotification)` `stopForeground(int)`同义词。
`final void`	`stopSelf()` 停止服务，如果它以前开始。
`final void`	`stopSelf(int startId)` 旧版本的 `stopSelfResult(int)`不返回结果。
`final boolean`	`stopSelfResult(int startId)` 如果最近一次启动的时间是 `startId，请`停止服务。

From class android.content.ContextWrapper

From class android.content.Context

`abstract boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` 连接到应用程序服务，根据需要创建它。
`abstract int`	`checkCallingOrSelfPermission(String permission)` 确定IPC的调用过程还是您已被授予特定权限。
`abstract int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` 确定IPC的调用进程或您是否被授予访问特定URI的权限。
`abstract int`	`checkCallingPermission(String permission)` 确定您正在处理的IPC的调用进程是否已被授予特定权限。
`abstract int`	`checkCallingUriPermission(Uri uri, int modeFlags)` 确定调用进程和用户标识是否已被授予访问特定URI的权限。
`abstract int`	`checkPermission(String permission, int pid, int uid)` 确定是否允许给定的权限用于系统中运行的特定进程和用户标识。
`abstract int`	`checkSelfPermission(String permission)` 确定您是否已获得特定权限。
`abstract int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` 检查Uri和普通权限。
`abstract int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` 确定是否已授予特定进程和用户标识访问特定URI的权限。
`abstract void`	`clearWallpaper()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.clear()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract Context`	`createConfigurationContext(Configuration overrideConfiguration)` 为当前上下文返回一个新的Context对象，但其资源被调整以匹配给定的配置。
`abstract Context`	`createDeviceProtectedStorageContext()` 为当前上下文返回一个新的Context对象，但其存储API由受设备保护的存储支持。
`abstract Context`	`createDisplayContext(Display display)` 为当前上下文返回一个新的Context对象，但其资源被调整为匹配给定Display的指标。
`abstract Context`	`createPackageContext(String packageName, int flags)` 为给定的应用程序名称返回一个新的Context对象。
`abstract String[]`	`databaseList()` 返回一个字符串数组，命名与此Context的应用程序包关联的专用数据库。
`abstract boolean`	`deleteDatabase(String name)` 删除与此Context的应用程序包关联的现有私有SQLiteDatabase。
`abstract boolean`	`deleteFile(String name)` 删除与此Context的应用程序包关联的给定私人文件。
`abstract boolean`	`deleteSharedPreferences(String name)` 删除现有的共享首选项文件。
`abstract void`	`enforceCallingOrSelfPermission(String permission, String message)` 如果您或您正在处理的IPC的调用过程都未获得特定许可，则抛出 `SecurityException` 。
`abstract void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` 如果IPC的调用进程或您未被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract void`	`enforceCallingPermission(String permission, String message)` 如果您正在处理的IPC的调用进程没有被授予特定权限，请抛出 `SecurityException` 。
`abstract void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` 如果调用进程和用户标识没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract void`	`enforcePermission(String permission, int pid, int uid, String message)` 如果给定权限不允许用于系统中运行的特定进程和用户标识，则抛出 `SecurityException` 。
`abstract void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` 强制执行Uri和普通权限。
`abstract void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` 如果某个特定的进程和用户标识没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract String[]`	`fileList()` 返回一个字符串数组，命名与此Context的应用程序包关联的私有文件。
`abstract Context`	`getApplicationContext()` 返回当前进程的单个全局应用程序对象的上下文。
`abstract ApplicationInfo`	`getApplicationInfo()` 返回此上下文包的完整应用程序信息。
`abstract AssetManager`	`getAssets()` 返回应用程序包的AssetManager实例。
`abstract File`	`getCacheDir()` 返回文件系统上特定于应用程序的缓存目录的绝对路径。
`abstract ClassLoader`	`getClassLoader()` 返回一个你可以用来检索这个包中的类的类加载器。
`abstract File`	`getCodeCacheDir()` 返回专用于存储缓存代码的文件系统上特定于应用程序的缓存目录的绝对路径。
`final int`	`getColor(int id)` 返回与特定资源ID关联的颜色并为当前主题设计样式。
`final ColorStateList`	`getColorStateList(int id)` 返回与特定资源ID关联的颜色状态列表，并为当前主题设计风格。
`abstract ContentResolver`	`getContentResolver()` 为你的应用程序包返回一个ContentResolver实例。
`abstract File`	`getDataDir()` 返回存储属于此应用程序的所有私人文件的文件系统上目录的绝对路径。
`abstract File`	`getDatabasePath(String name)` 返回存储使用 `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)`创建的数据库的文件系统上的绝对路径。
`abstract File`	`getDir(String name, int mode)` 根据需要检索，创建应用程序可以放置自己的自定义数据文件的新目录。
`final Drawable`	`getDrawable(int id)` 返回与特定资源ID关联的可绘制对象，并为当前主题创建样式。
`abstract File`	`getExternalCacheDir()` 返回应用程序可以放置其拥有的缓存文件的主共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File[]`	`getExternalCacheDirs()` 返回应用程序可以放置它拥有的缓存文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File`	`getExternalFilesDir(String type)` 返回应用程序可以放置其拥有的持久性文件的主共享/外部存储设备上目录的绝对路径。
`abstract File[]`	`getExternalFilesDirs(String type)` 返回应用程序可以放置其拥有的持久性文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File[]`	`getExternalMediaDirs()` 返回应用程序可放置媒体文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File`	`getFileStreamPath(String name)` 返回存储使用 `openFileOutput(String, int)`创建的文件的文件系统上的绝对路径。
`abstract File`	`getFilesDir()` 返回存储使用 `openFileOutput(String, int)`创建的文件的文件系统上目录的绝对路径。
`abstract Looper`	`getMainLooper()` 返回当前进程主线程的Looper。
`abstract File`	`getNoBackupFilesDir()` 返回类似于 `getFilesDir()`的文件系统上目录的绝对路径。
`abstract File`	`getObbDir()` 返回此应用程序的OBB文件（如果有）的主要共享/外部存储目录。
`abstract File[]`	`getObbDirs()` 返回应用程序的OBB文件（如果有）的所有共享/外部存储设备上的应用程序特定目录的绝对路径。
`abstract String`	`getPackageCodePath()` 返回此上下文的主要Android包的完整路径。
`abstract PackageManager`	`getPackageManager()` 返回PackageManager实例以查找全局包信息。
`abstract String`	`getPackageName()` 返回此应用程序包的名称。
`abstract String`	`getPackageResourcePath()` 返回此上下文的主要Android包的完整路径。
`abstract Resources`	`getResources()` 返回应用程序包的资源实例。
`abstract SharedPreferences`	`getSharedPreferences(String name, int mode)` 检索并保存首选项文件'name'的内容，返回一个SharedPreferences，通过它可以检索和修改其值。
`final String`	`getString(int resId, Object... formatArgs)` 从应用程序包的默认字符串表中返回一个本地化的格式化字符串，用 `Formatter`和 `format(String, Object...)`定义的格式参数 `format(String, Object...)` 。
`final String`	`getString(int resId)` 从应用程序包的默认字符串表中返回一个本地化的字符串。
`final <T> T`	`getSystemService(Class<T> serviceClass)` 按类返回句柄到系统级服务。
`abstract Object`	`getSystemService(String name)` 按名称将句柄返回到系统级服务。
`abstract String`	`getSystemServiceName(Class<?> serviceClass)` 获取由指定的类表示的系统级服务的名称。
`final CharSequence`	`getText(int resId)` 从应用程序包的默认字符串表中返回一个本地化的，风格化的CharSequence。
`abstract Resources.Theme`	`getTheme()` 返回与此上下文关联的主题对象。
`abstract Drawable`	`getWallpaper()` 此方法在API级别5中已弃用。请改用`WallpaperManager.get()` 。
`abstract int`	`getWallpaperDesiredMinimumHeight()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.getDesiredMinimumHeight()` 。
`abstract int`	`getWallpaperDesiredMinimumWidth()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.getDesiredMinimumWidth()` 。
`abstract void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` 无论该软件包是否具有访问Uri内容提供者的一般权限，都可以授予访问另一个软件包的特定Uri的权限。
`abstract boolean`	`isDeviceProtectedStorage()` 指示此Context的存储API是否受设备保护存储支持。
`boolean`	`isRestricted()` 指示此上下文是否受限制。
`abstract boolean`	`moveDatabaseFrom(Context sourceContext, String name)` 将现有数据库文件从给定的源存储上下文移动到此上下文。
`abstract boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` 将现有的共享首选项文件从给定的源存储上下文移至此上下文。
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(int resid, int[] attrs)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(int[] attrs)` 在此Context的主题中检索样式化属性信息。
`abstract FileInputStream`	`openFileInput(String name)` 打开与此Context的应用程序包关联的私人文件以供阅读。
`abstract FileOutputStream`	`openFileOutput(String name, int mode)` 打开与此Context的应用程序包关联的私有文件以进行写入。
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`abstract Drawable`	`peekWallpaper()` 此方法在API级别5中已弃用。请改用`WallpaperManager.peek()` 。
`void`	`registerComponentCallbacks(ComponentCallbacks callback)` 在Context的基本应用程序中添加一个新的 `ComponentCallbacks` ，它将在调用ComponentCallbacks活动方法和其他组件的同时调用。
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` 注册BroadcastReceiver以在主要活动线程中运行。
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` 注册以接收意图广播，以在 `调度程序`的上下文中运行。
`abstract void`	`removeStickyBroadcast(Intent intent)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`revokeUriPermission(Uri uri, int modeFlags)` 删除所有权限以访问之前添加了 `grantUriPermission(String, Uri, int)`的特定内容提供商Uri。
`abstract void`	`sendBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，允许强制执行可选的必需权限。
`abstract void`	`sendBroadcast(Intent intent)` 将给定的意图广播给所有感兴趣的BroadcastReceivers。
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` 版本 `sendBroadcast(Intent)` ，允许您指定广播将被发送到的用户。
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` 版本 `sendBroadcast(Intent, String)` ，允许您指定广播将被发送到的用户。
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本 `sendBroadcast(Intent)` ，允许您从广播接收数据。
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，一次发送一个，让更多的首选接收者在将广播发送给次优先接收者之前消费广播。
`abstract void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本 `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` ，允许您指定广播将发送到的用户。
`abstract void`	`sendStickyBroadcast(Intent intent)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`setTheme(int resid)` 为此上下文设置基本主题。
`abstract void`	`setWallpaper(Bitmap bitmap)` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract void`	`setWallpaper(InputStream data)` 此方法在API级别5中已弃用。请改用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract void`	`startActivities(Intent[] intents, Bundle options)` 启动多项新活动。
`abstract void`	`startActivities(Intent[] intents)` 与没有指定选项的 `startActivities(Intent[], Bundle)`相同。
`abstract void`	`startActivity(Intent intent)` 与没有指定选项的 `startActivity(Intent, Bundle)`相同。
`abstract void`	`startActivity(Intent intent, Bundle options)` 启动一项新活动。
`abstract boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` 开始执行 `Instrumentation`类。
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` 与 `startIntentSender(IntentSender, Intent, int, int, int, Bundle)`相同，没有指定选项。
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` 像 `startActivity(Intent, Bundle)`一样，但需要启动一个IntentSender。
`abstract ComponentName`	`startService(Intent service)` 请求启动给定的应用程序服务。
`abstract boolean`	`stopService(Intent service)` 请求停止给定的应用程序服务。
`abstract void`	`unbindService(ServiceConnection conn)` 断开应用程序服务。
`void`	`unregisterComponentCallbacks(ComponentCallbacks callback)` 删除以前用 `registerComponentCallbacks(ComponentCallbacks)`注册的 `ComponentCallbacks`对象。
`abstract void`	`unregisterReceiver(BroadcastReceiver receiver)` 取消注册以前注册的BroadcastReceiver。

From class java.lang.Object

From interface android.content.ComponentCallbacks2

From interface android.view.Window.Callback

From interface android.content.ComponentCallbacks

常量(Constants)

DREAM_META_DATA

Added in API level 17

String DREAM_META_DATA

Dream发布自己的信息的名称。此元数据必须引用包含<dream>标记的XML资源。

常量值：“android.service.dream”

SERVICE_INTERFACE

Added in API level 17

String SERVICE_INTERFACE

Intent必须声明为由服务处理。

常量值：“android.service.dreams.DreamService”

Public constructors

DreamService

Added in API level 17

DreamService ()

公共方法(Public methods)

addContentView

Added in API level 17

void addContentView (View view, 
                ViewGroup.LayoutParams params)

将视图添加到Dream的窗口，留下其他内容视图。

注意：需要一个窗口，请勿在 onAttachedToWindow()之前 onAttachedToWindow()

参数(Parameters)
`view`	`View`: The desired content to display.
`params`	`ViewGroup.LayoutParams`: Layout parameters for the view.

dispatchGenericMotionEvent

Added in API level 17

boolean dispatchGenericMotionEvent (MotionEvent event)

被调用来处理通用运动事件。至少您的实现必须调用superDispatchGenericMotionEvent(MotionEvent)来执行标准处理。

参数(Parameters)
`event`	`MotionEvent`: The generic motion event.

返回(Returns)
`boolean`	boolean Return true if this event was consumed.

dispatchKeyEvent

Added in API level 17

boolean dispatchKeyEvent (KeyEvent event)

被调用来处理关键事件。至少您的实现必须调用superDispatchKeyEvent(KeyEvent)来执行标准密钥处理。

参数(Parameters)
`event`	`KeyEvent`: The key event.

返回(Returns)
`boolean`	boolean Return true if this event was consumed.

dispatchKeyShortcutEvent

Added in API level 17

boolean dispatchKeyShortcutEvent (KeyEvent event)

被调用来处理键快捷键事件。至少你的实现必须调用superDispatchKeyShortcutEvent(KeyEvent)来执行标准的快捷键处理。

参数(Parameters)
`event`	`KeyEvent`: The key shortcut event.

返回(Returns)
`boolean`	True if this event was consumed.

dispatchPopulateAccessibilityEvent

Added in API level 17

boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event)

打电话来处理 AccessibilityEvent的人口。

参数(Parameters)
`event`	`AccessibilityEvent`: The event.

返回(Returns)
`boolean`	boolean Return true if event population was completed.

dispatchTouchEvent

Added in API level 17

boolean dispatchTouchEvent (MotionEvent event)

被调用来处理触摸屏事件。至少你的实现必须调用superDispatchTouchEvent(MotionEvent)来完成标准的触摸屏处理。

参数(Parameters)
`event`	`MotionEvent`: The touch screen event.

返回(Returns)
`boolean`	boolean Return true if this event was consumed.

dispatchTrackballEvent

Added in API level 17

boolean dispatchTrackballEvent (MotionEvent event)

被称为处理轨迹球事件。至少你的实现必须调用superDispatchTrackballEvent(MotionEvent)来执行标准的轨迹球处理。

参数(Parameters)
`event`	`MotionEvent`: The trackball event.

返回(Returns)
`boolean`	boolean Return true if this event was consumed.

findViewById

Added in API level 17

View findViewById (int id)

查找由 onCreate()中处理的XML中的id属性标识的视图。

注意：需要一个窗口，请勿在 onAttachedToWindow()之前 onAttachedToWindow()

参数(Parameters)
`id`	`int`

返回(Returns)
`View`	The view if found or null otherwise.

finish

Added in API level 17

void finish ()

停止梦想并脱离窗口。

当梦想结束时，系统将被允许完全进入睡眠状态，除非有理由让它醒来，例如最近的用户活动或唤醒锁定。

getWindow

Added in API level 17

Window getWindow ()

为梦想检索当前Window 。行为与getWindow()类似。

返回(Returns)
`Window`	The current window, or null if the dream is not started.

getWindowManager

Added in API level 17

WindowManager getWindowManager ()

为梦想检索当前WindowManager 。行为类似于getWindowManager() 。

返回(Returns)
`WindowManager`	The current window manager, or null if the dream is not started.

isFullscreen

Added in API level 17

boolean isFullscreen ()

返回此梦是否处于全屏模式。默认为false。

返回(Returns)
`boolean`

也可以看看：

setFullscreen(boolean)

isInteractive

Added in API level 17

boolean isInteractive ()

返回这个梦是否是互动的。默认为false。

返回(Returns)
`boolean`

也可以看看：

setInteractive(boolean)

isScreenBright

Added in API level 17

boolean isScreenBright ()

返回这个梦是否在梦中保持屏幕亮度。默认为false，允许屏幕在必要时变暗。

返回(Returns)
`boolean`

也可以看看：

setScreenBright(boolean)

onActionModeFinished

Added in API level 17

void onActionModeFinished (ActionMode mode)

当动作模式完成时调用。适当的模式回调方法已经被调用。

参数(Parameters)
`mode`	`ActionMode`: The mode that was just finished.

onActionModeStarted

Added in API level 17

void onActionModeStarted (ActionMode mode)

当动作模式已启动时调用。适当的模式回调方法已经被调用。

参数(Parameters)
`mode`	`ActionMode`: The new mode that has just been started.

onAttachedToWindow

Added in API level 17

void onAttachedToWindow ()

当窗口已连接到窗口管理器时调用。有关更多信息，请参阅View.onAttachedToWindow() 。

onBind

Added in API level 17

IBinder onBind (Intent intent)

将通信信道返回给服务。如果客户端无法绑定到服务，可能会返回null。返回IBinder通常是一个复杂的界面已经described using aidl 。

请注意，与其他应用程序组件不同，此处返回的IBinder接口调用可能不会发生在进程的主线程上 。有关主线程的更多信息可以在Processes and Threads中找到。

参数(Parameters)
`intent`	`Intent`: The Intent that was used to bind to this service, as given to `Context.bindService`. Note that any extras that were included with the Intent at that point will not be seen here.

返回(Returns)
`IBinder`	Return an IBinder through which clients can call on to the service.

onContentChanged

Added in API level 17

void onContentChanged ()

只要屏幕的内容视图发生变化（由于调用 Window.setContentView或 Window.addContentView ）， Window.setContentView调用此钩子。

onCreate

Added in API level 17

void onCreate ()

当这个梦被构建时调用。

onCreatePanelMenu

Added in API level 17

boolean onCreatePanelMenu (int featureId, 
                Menu menu)

初始化面板'featureId'的菜单内容。如果onCreatePanelView（）返回null，这会被调用，为您提供一个标准菜单，您可以在其中放置项目。它仅在面板显示时才被调用一次。

您可以安全地按住 菜单 （以及从中创建的任何项目），根据需要对其进行修改，直到下次为此功能调用onCreatePanelMenu（）。

参数(Parameters)
`featureId`	`int`: The panel being created.
`menu`	`Menu`: The menu inside the panel.

返回(Returns)
`boolean`	boolean You must return true for the panel to be displayed; if you return false it will not be shown.

onCreatePanelView

Added in API level 17

View onCreatePanelView (int featureId)

实例化视图以显示在“featureId”的面板中。您可以返回null，在这种情况下，将为您创建默认内容（通常是菜单）。

参数(Parameters)
`featureId`	`int`: Which panel is being created.

返回(Returns)
`View`	view The top-level view to place in the panel.

onDestroy

Added in API level 17

void onDestroy ()

由系统调用以通知服务它已不再使用并正在被删除。这个服务应该清理它所拥有的任何资源（线程，注册接收者等）。返回后，将不会有更多的调用这个服务对象，它实际上已经死了。不要直接调用这个方法。

onDetachedFromWindow

Added in API level 17

void onDetachedFromWindow ()

当窗口已连接到窗口管理器时调用。有关更多信息，请参阅View.onDetachedFromWindow() 。

onDreamingStarted

Added in API level 17

void onDreamingStarted ()

当梦的窗口已经创建并且可见并且动画现在可以开始时调用。

onDreamingStopped

Added in API level 17

void onDreamingStopped ()

当窗口被移除之前，当这个梦被停止时，通过外部请求或调用finish（）来调用。

onMenuItemSelected

Added in API level 17

boolean onMenuItemSelected (int featureId, 
                MenuItem item)

当用户选择了面板的菜单项时调用。

参数(Parameters)
`featureId`	`int`: The panel that the menu is in.
`item`	`MenuItem`: The menu item that was selected.

返回(Returns)
`boolean`	boolean Return true to finish processing of selection, or false to perform the normal menu handling (calling its Runnable or sending a Message to its target Handler).

onMenuOpened

Added in API level 17

boolean onMenuOpened (int featureId, 
                Menu menu)

用户打开面板菜单时调用。当菜单从一种类型更改为另一种时（例如，从图标菜单变为扩展菜单），也可能会调用此功能。

参数(Parameters)
`featureId`	`int`: The panel that the menu is in.
`menu`	`Menu`: The menu that is opened.

返回(Returns)
`boolean`	Return true to allow the menu to open, or false to prevent the menu from opening.

onPanelClosed

Added in API level 17

void onPanelClosed (int featureId, 
                Menu menu)

当面板关闭时调用。如果正在打开另一个逻辑后续面板（并且该面板正在关闭以为后面的面板腾出空间），则不会调用此方法。

参数(Parameters)
`featureId`	`int`: The panel that is being displayed.
`menu`	`Menu`: If onCreatePanelView() returned null, this is the Menu being displayed in the panel.

onPreparePanel

Added in API level 17

boolean onPreparePanel (int featureId, 
                View view, 
                Menu menu)

准备要显示的面板。在每次显示面板窗口之前调用它。

参数(Parameters)
`featureId`	`int`: The panel that is being displayed.
`view`	`View`: The View that was returned by onCreatePanelView().
`menu`	`Menu`: If onCreatePanelView() returned null, this is the Menu being displayed in the panel.

返回(Returns)
`boolean`	boolean You must return true for the panel to be displayed; if you return false it will not be shown.

onSearchRequested

Added in API level 17

boolean onSearchRequested ()

当用户指示开始搜索的愿望时调用。

返回(Returns)
`boolean`	true if search launched, false if activity refuses (blocks)

onSearchRequested

Added in API level 23

boolean onSearchRequested (SearchEvent event)

当用户指示开始搜索的愿望时调用。

参数(Parameters)
`event`	`SearchEvent`: A `SearchEvent` describing the signal to start a search.

返回(Returns)
`boolean`	true if search launched, false if activity refuses (blocks)

onWakeUp

Added in API level 21

void onWakeUp ()

当梦想被要求停止并唤醒时调用。

默认实现只需调用finish()即可立即结束梦想。子类可以重写此函数以执行平滑的退出转换，然后再调用finish() 。

请注意，梦想只会在短时间内（现在约五秒钟）才会醒来。如果梦想没有及时完成，那么一旦时间允许，系统将强制完成它。

onWindowAttributesChanged

Added in API level 17

void onWindowAttributesChanged (WindowManager.LayoutParams attrs)

这在每当当前窗口属性改变时被调用。

参数(Parameters)
`attrs`	`WindowManager.LayoutParams`

onWindowFocusChanged

Added in API level 17

void onWindowFocusChanged (boolean hasFocus)

这个钩子在窗口焦点改变时被调用。有关更多信息，请参阅View.onWindowFocusChangedNotLocked(boolean) 。

参数(Parameters)
`hasFocus`	`boolean`: Whether the window now has focus.

onWindowStartingActionMode

Added in API level 17

ActionMode onWindowStartingActionMode (ActionMode.Callback callback)

当此窗口的动作模式正在启动时调用。给回调提供了一个机会，以自己独特而美丽的方式处理动作模式。如果此方法返回null，则系统可以选择一种呈现模式的方式或根本不选择启动模式。这相当于onWindowStartingActionMode(android.view.ActionMode.Callback, int)和TYPE_PRIMARY 。

参数(Parameters)
`callback`	`ActionMode.Callback`: Callback to control the lifecycle of this action mode

返回(Returns)
`ActionMode`	The ActionMode that was started, or null if the system should present it

onWindowStartingActionMode

Added in API level 23

ActionMode onWindowStartingActionMode (ActionMode.Callback callback, 
                int type)

当此窗口的动作模式正在启动时调用。给回调提供了一个机会，以自己独特而美丽的方式处理动作模式。如果此方法返回null，则系统可以选择一种呈现模式的方式或根本不选择启动模式。

参数(Parameters)
`callback`	`ActionMode.Callback`: Callback to control the lifecycle of this action mode
`type`	`int`: One of `TYPE_PRIMARY` or `TYPE_FLOATING`.

返回(Returns)
`ActionMode`	The ActionMode that was started, or null if the system should present it

setContentView

Added in API level 17

void setContentView (View view)

将视图设置为此Dream的内容视图。在活动中的行为与setContentView(android.view.View)行为类似，包括使用MATCH_PARENT作为视图的布局高度和宽度。

注意：这需要一个窗口，所以您通常应该在 onAttachedToWindow()期间调用它，并且从不提前（在 onCreate()期间不能调用它）。

参数(Parameters)
`view`	`View`

也可以看看：

setContentView

Added in API level 17

void setContentView (int layoutResID)

使布局资源膨胀并将其设置为此Dream的内容视图。表现类似于setContentView(int) 。

注意：需要一个窗口，不要在 onAttachedToWindow()之前 onAttachedToWindow()

参数(Parameters)
`layoutResID`	`int`: Resource ID to be inflated.

也可以看看：

setContentView

Added in API level 17

void setContentView (View view, 
                ViewGroup.LayoutParams params)

将视图设置为此Dream的内容视图。在活动中与setContentView(android.view.View, android.view.ViewGroup.LayoutParams)行为类似。

注意：这需要一个窗口，所以通常应该在 onAttachedToWindow()期间调用它，并且从不提前（在 onCreate()期间不能调用它）。

参数(Parameters)
`view`	`View`: The desired content to display.
`params`	`ViewGroup.LayoutParams`: Layout parameters for the view.

也可以看看：

setFullscreen

Added in API level 17

void setFullscreen (boolean fullscreen)

在梦想窗口上控制 FLAG_FULLSCREEN 。

参数(Parameters)
`fullscreen`	`boolean`: If true, the fullscreen flag will be set; else it will be cleared.

setInteractive

Added in API level 17

void setInteractive (boolean interactive)

将此梦想标记为交互式以接收输入事件。

非交互式梦想（默认）会在第一个输入事件中消失。

互动梦想应该叫 finish()解雇自己。

参数(Parameters)
`interactive`	`boolean`: True if this dream will handle input events.

setScreenBright

Added in API level 17

void setScreenBright (boolean screenBright)

将这个梦想标志为在梦中保持屏幕亮度。

参数(Parameters)
`screenBright`	`boolean`: True to keep the screen bright while dreaming.

wakeUp

Added in API level 21

void wakeUp ()

轻轻唤醒梦。

致电onWakeUp()让梦想有机会执行退出过渡。当转换结束时，梦想应该调用finish() 。

Protected methods

dump

Added in API level 17

void dump (FileDescriptor fd, 
                PrintWriter pw, 
                String[] args)

将服务的状态打印到给定的流中。如果您运行“adb shell dumpsys activity service <yourservicename>”（注意，要使此命令生效，服务必须正在运行，并且您必须指定完全限定的服务名称），则会调用此命令。这与“dumpsys <servicename>”不同，后者仅适用于命名系统服务，并在使用ServiceManager注册的IBinder接口上调用dump(FileDescriptor, String[])方法。

参数(Parameters)
`fd`	`FileDescriptor`: The raw file descriptor that the dump is being sent to.
`pw`	`PrintWriter`: The PrintWriter to which you should dump your state. This will be closed for you after you return.
`args`	`String`: additional arguments to the dump request.