Most visited

Recently visited

Results for

Added in API level 19

PrintService

public abstract class PrintService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.printservice.PrintService

这是实现打印服务的基类。打印服务知道如何通过一个或多个协议发现和交互一台或多台打印机。

Printer discovery

打印服务负责发现打印机，添加发现的打印机，删除添加的打印机以及更新添加的打印机。当系统对由您的服务管理的打印机感兴趣时，它将调用onCreatePrinterDiscoverySession() ，您必须从中返回一个新的PrinterDiscoverySession实例。返回的会话在打印机发现期间封装了系统和您的服务之间的交互。有关此交互的说明，请参阅PrinterDiscoverySession的文档。

对于每个打印机发现会话，都必须添加所有打印机，因为系统不会在会话中保留打印机。因此，打印服务已知的每台打印机应在发现会话期间仅添加一次。只有已添加的打印机才能被删除或更新。删除的打印机可以再次添加。

Print jobs

当针对由此打印服务管理的打印机的新打印作业正在排队时，即准备好由打印服务处理时，您将收到对onPrintJobQueued(PrintJob)的呼叫。打印服务可能会立即处理打印作业，或在未来适当的时间安排打印作业。通过调用getActivePrintJobs()获取此服务的所有活动打印作业的列表。活动的打印作业是排队或开始的作业。

打印服务负责在处理打印作业时酌情设置打印作业的状态。最初，打印作业正在排队，即PrintJob.isQueued()返回true，这意味着要打印的文档被系统假脱机并且打印服务可以开始处理它。您可以拨打电话PrintJob.getDocument()来获取打印的文件，其数据通过PrintDocument.getData()访问。在打印服务开始打印数据后，它应该通过调用start()将打印作业的状态设置为开始，之后PrintJob.isStarted()将返回true。成功完成后，应通过调用PrintJob.complete()将打印作业标记为已完成，之后PrintJob.isCompleted()将返回true。如果出现故障，应通过调用PrintJob.fail( String)将该打印作业标记为失败，之后PrintJob.isFailed()将返回true。

如果打印作业已排队或开始并且用户请求取消打印作业，则打印服务将收到对onRequestCancelPrintJob(PrintJob)的呼叫，请求服务部门尽最大努力取消作业。如果作业被成功取消，其状态已通过调用作为取消被标记PrintJob.cancel()之后PrintJob.isCacnelled()将返回true。

Lifecycle

打印服务的生命周期仅由系统管理，并遵循已建立的服务生命周期。此外，启动或停止打印服务是通过在设备设置中启用或禁用显式用户操作来完全触发的。系统绑定到打印服务后，它调用onConnected() 。客户端可以重写此方法以执行绑定后设置。系统从打印服务中解除绑定后，它会调用onDisconnected() 。客户端可以重写此方法以执行解除后绑定清理。在系统与打印服务断开连接后，您不应该做任何工作，因为可以随时终止服务以回收内存。如果由其管理的打印机有活动的打印作业，则系统不会从打印服务断开连接。

Declaration

打印服务被声明为在AndroidManifest.xml中任何其他服务，但它也必须指定它处理Intent用行动android.printservice.PrintService 。未能声明此意图将导致系统忽略打印服务。此外，打印服务必须请求android.permission.BIND_PRINT_SERVICE权限才能确保只有系统可以绑定到它。未能声明此意图将导致系统忽略打印服务。以下是一个示例声明：

 <service android:name=".MyPrintService"
         android:permission="android.permission.BIND_PRINT_SERVICE">
     <intent-filter>
         <action android:name="android.printservice.PrintService" />
     </intent-filter>
     . . .
 </service>

Configuration

打印服务可以通过指定一个可选的设置活动进行配置，该活动可以显示特定于服务的设置，可选的添加打印机活动，用于手动添加打印机，供应商名称等。在适当的时候启动设置并添加打印机活动是系统的责任。

通过在声明服务时在清单中提供meta-data条目来配置打印服务。具有元数据标签的服务声明如下所示：

 <service android:name=".MyPrintService"
         android:permission="android.permission.BIND_PRINT_SERVICE">
     <intent-filter>
         <action android:name="android.printservice.PrintService" />
     </intent-filter>
     <meta-data android:name="android.printservice" android:resource="@xml/printservice" />
 </service>

有关如何通过元数据配置打印服务的更多详细信息，请参阅 SERVICE_META_DATA和 <print-service> 。

注意：此类中的所有回调都在主应用程序线程上执行。您还应该在主应用程序线程上调用此类的任何方法。

Summary

Constants
`String`	`EXTRA_PRINTER_INFO` 如果您通过 `advancedPrintOptionsActivity`属性声明了具有高级打印选项的可选活动，则此额外用于将当前选定打印机的 `PrinterInfo`给您的活动，以便您检查它。
`String`	`EXTRA_PRINT_DOCUMENT_INFO` 如果您通过 `advancedPrintOptionsActivity`属性声明了具有高级打印选项的可选活动，则此额外用于将当前打印文档的元数据作为 `PrintDocumentInfo`给您的活动，以 `PrintDocumentInfo`您检查它。
`String`	`EXTRA_PRINT_JOB_INFO` 如果您通过 `advancedPrintOptionsActivity`属性声明了具有高级打印选项的可选活动，则使用此额外内容将当前构建的 `PrintJobInfo`给您的活动，以便您修改它。
`String`	`SERVICE_INTERFACE` `Intent`必须声明为由其清单中的服务处理的操作，以便系统将其识别为打印服务。
`String`	`SERVICE_META_DATA` `PrintService`组件发布有关其自身的附加信息的名称。

Inherited constants

From class android.app.Service

From class android.content.Context

From interface android.content.ComponentCallbacks2

Public constructors
`PrintService()`

Public methods
`final PrinterId`	`generatePrinterId(String localId)` 生成打印机本地唯一的全局打印机ID。
`final List<PrintJob>`	`getActivePrintJobs()` 获取由此服务管理的打印机的活动打印作业。
`final IBinder`	`onBind(Intent intent)` 将通信信道返回给服务。

Protected methods
`final void`	`attachBaseContext(Context base)` 为此ContextWrapper设置基本上下文。
`void`	`onConnected()` 系统已连接到此服务。
`abstract PrinterDiscoverySession`	`onCreatePrinterDiscoverySession()` 回拨要求您创建一个新的 `PrinterDiscoverySession` 。
`void`	`onDisconnected()` 系统已与此服务断开连接。
`abstract void`	`onPrintJobQueued(PrintJob printJob)` 当由此打印服务管理的其中一台打印机有排队的打印作业时调用。
`abstract void`	`onRequestCancelPrintJob(PrintJob printJob)` 在请求取消打印作业时调用。

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...)`定义的格式参数。
`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.content.ComponentCallbacks

Constants

EXTRA_PRINTER_INFO

Added in API level 21

String EXTRA_PRINTER_INFO

如果您通过 advancedPrintOptionsActivity属性声明了具有高级打印选项的可选活动，则此额外用于将当前选定打印机的 PrinterInfo给您的活动，以便您检查它。

也可以看看：

EXTRA_PRINT_JOB_INFO

常量值：“android.intent.extra.print.EXTRA_PRINTER_INFO”

EXTRA_PRINT_DOCUMENT_INFO

Added in API level 23

String EXTRA_PRINT_DOCUMENT_INFO

如果您通过 advancedPrintOptionsActivity属性声明了具有高级打印选项的可选活动，则此额外用于将当前打印文档的元数据作为 PrintDocumentInfo给您的活动，以 PrintDocumentInfo您检查它。

也可以看看：

常量值：“android.printservice.extra.PRINT_DOCUMENT_INFO”

EXTRA_PRINT_JOB_INFO

Added in API level 19

String EXTRA_PRINT_JOB_INFO

如果您通过advancedPrintOptionsActivity属性声明了具有高级打印选项的可选活动，则使用此额外内容将当前构建的PrintJobInfo给您的活动，以便您修改它。完成之后，您必须通过相同的额外返回修改后的PrintJobInfo 。

您不能直接修改PrintJobInfo的传递，而应该使用PrintJobInfo.Builder类构建另一个。您可以指定任何标准属性并通过PrintJobInfo.Builder.putAdvancedOption(String, String)和PrintJobInfo.Builder.putAdvancedOption(String, int)添加高级打印机特定的PrintJobInfo.Builder.putAdvancedOption(String, int) 。高级选项不被系统解释，它们对于应用程序不可见，只能由您的打印服务通过PrintJob.getAdvancedStringOption(String)和PrintJob.getAdvancedIntOption(String) 。

如果高级打印选项活动提供更改标准打印选项，你可以得到当前PrinterInfo使用EXTRA_PRINTER_INFO多余的，这将使您呈现与当前打印机支持的UI选项的用户。例如，如果当前打印机不支持给定的介质尺寸，则不应在高级打印选项UI中提供它。

也可以看看：

EXTRA_PRINTER_INFO

常量值：“android.intent.extra.print.PRINT_JOB_INFO”

SERVICE_INTERFACE

Added in API level 19

String SERVICE_INTERFACE

必须声明的 Intent操作由其清单中的服务处理，以便系统将其识别为打印服务。

常量值：“android.printservice.PrintService”

SERVICE_META_DATA

Added in API level 19

String SERVICE_META_DATA

PrintService组件发布有关其自身的附加信息的名称。此元数据必须引用包含<print-service>标记的XML资源。这是配置打印服务的示例XML文件：

 <print-service
     android:vendor="SomeVendor"
     android:settingsActivity="foo.bar.MySettingsActivity"
     andorid:addPrintersActivity="foo.bar.MyAddPrintersActivity."
     . . .
 />

有关可通过元数据指定的详细配置选项，请参阅 android.R.styleable.PrintService 。

如果您声明设置或添加打印机活动，则必须将其导出，方法是将exported活动属性设置为true 。此外，如果您只希望系统能够启动任何这些活动，您可以指定他们通过设置permission活动属性来请求android.permission.START_PRINT_SERVICE_CONFIG_ACTIVITY权限。

常量值：“android.printservice”

Public constructors

PrintService

Added in API level 19

PrintService ()

Public methods

generatePrinterId

Added in API level 19

PrinterId generatePrinterId (String localId)

生成打印机本地唯一的全局打印机ID。

Parameters
`localId`	`String`: A locally unique id in the context of your print service.

Returns
`PrinterId`	Global printer id.

getActivePrintJobs

Added in API level 19

List<PrintJob> getActivePrintJobs ()

获取由此服务管理的打印机的活动打印作业。活动打印作业是未处于最终状态的作业，即其状态排队或开始。

Returns
`List<PrintJob>`	The active print jobs.

也可以看看：

onBind

Added in API level 19

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.

Protected methods

attachBaseContext

Added in API level 19

void attachBaseContext (Context base)

为此ContextWrapper设置基本上下文。所有的调用都会被委托给基础上下文。如果已经设置了基本上下文，则引发IllegalStateException。

Parameters
`base`	`Context`: The new base context for this wrapper.

onConnected

Added in API level 19

void onConnected ()

系统已连接到此服务。

onCreatePrinterDiscoverySession

Added in API level 19

PrinterDiscoverySession onCreatePrinterDiscoverySession ()

回拨要求您创建一个新的 PrinterDiscoverySession 。

Returns
`PrinterDiscoverySession`	The created session.

也可以看看：

PrinterDiscoverySession

onDisconnected

Added in API level 19

void onDisconnected ()

系统已与此服务断开连接。

onPrintJobQueued

Added in API level 19

void onPrintJobQueued (PrintJob printJob)

当由此打印服务管理的其中一台打印机有排队的打印作业时调用。

Parameters
`printJob`	`PrintJob`: The new queued print job.

也可以看看：

onRequestCancelPrintJob

Added in API level 19

void onRequestCancelPrintJob (PrintJob printJob)

在请求取消打印作业时调用。该服务应该尽最大努力来满足要求。执行取消操作后，应通过调用cancel()将打印作业标记为取消状态。

Parameters
`printJob`	`PrintJob`: The print job to cancel.

也可以看看：