Most visited

Recently visited

Added in API level 7

WallpaperService

public abstract class WallpaperService
extends Service

java.lang.Object
   ↳ android.content.Context
     ↳ android.content.ContextWrapper
       ↳ android.app.Service
         ↳ android.service.wallpaper.WallpaperService


壁纸服务负责在想要坐在其上的应用程序后面显示动态壁纸。 这个服务对象本身做的很少 - 它的唯一目的是根据需要生成WallpaperService.Engine实例。 因此,实现壁纸涉及从这个子类onCreateEngine() ,子类化Engine实现,并实现onCreateEngine()以返回引擎的新实例。

Summary

Nested classes

class WallpaperService.Engine

墙纸的实际实施。

Constants

String SERVICE_INTERFACE

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

String SERVICE_META_DATA

名称下的一个WallpaperService组件发布有关自己的信息。

Inherited constants

From class android.app.Service
From class android.content.Context
From interface android.content.ComponentCallbacks2

Public constructors

WallpaperService()

Public methods

final IBinder onBind(Intent intent)

实现返回内部辅助功能服务接口的实现。

void onCreate()

服务第一次创建时由系统调用。

abstract WallpaperService.Engine onCreateEngine()

必须实施才能返回壁纸引擎的新实例。

void onDestroy()

由系统调用以通知服务它已不再使用并正在被删除。

Protected methods

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

将服务的状态打印到给定的流中。

Inherited methods

From class android.app.Service
From class android.content.ContextWrapper
From class android.content.Context
From class java.lang.Object
From interface android.content.ComponentCallbacks2
From interface android.content.ComponentCallbacks

Constants

SERVICE_INTERFACE

Added in API level 7
String SERVICE_INTERFACE

Intent必须声明为由服务处理。 为了得到支持,该服务还必须要求BIND_WALLPAPER权限,以便其他应用程序不能滥用它。

常量值:“android.service.wallpaper.WallpaperService”

SERVICE_META_DATA

Added in API level 7
String SERVICE_META_DATA

名称下的一个WallpaperService组件发布有关自己的信息。 此元数据必须引用包含<wallpaper>标签的XML资源。

常量值:“android.service.wallpaper”

Public constructors

WallpaperService

Added in API level 7
WallpaperService ()

Public methods

onBind

Added in API level 7
IBinder onBind (Intent intent)

实现返回内部辅助功能服务接口的实现。 子类不应该重写。

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.

onCreate

Added in API level 7
void onCreate ()

服务第一次创建时由系统调用。 不要直接调用这个方法。

onCreateEngine

Added in API level 7
WallpaperService.Engine onCreateEngine ()

必须实施才能返回壁纸引擎的新实例。 请注意,多个实例可能同时处于活动状态,例如当壁纸当前设置为活动壁纸并且用户在壁纸选取器中时,也会查看其预览。

Returns
WallpaperService.Engine

onDestroy

Added in API level 7
void onDestroy ()

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

Protected methods

dump

Added in API level 7
void dump (FileDescriptor fd, 
                PrintWriter out, 
                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.
out 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.

Hooray!