Most visited

Recently visited

Results for

Added in API level 19

HostApduService

public abstract class HostApduService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.nfc.cardemulation.HostApduService

HostApduService是一个便利的 Service类，可以扩展为模拟Android服务组件内的NFC卡。

Developer Guide

For a general introduction to card emulation, see Host-based Card Emulation.

NFC Protocols

该类仿真的卡基于NFC-Forum ISO-DEP协议（基于ISO / IEC 14443-4），并支持ISO / IEC 7816-4规范中定义的处理命令应用协议数据单元（APDU）。

Service selection

当远程NFC设备想要与您的服务通话时，它会发送ISO / IEC 7816-4规范中定义的所谓“SELECT AID”APDU。 AID是ISO / IEC 7816-4中定义的应用程序标识符。

AID的注册程序在ISO / IEC 7816-5规范中定义。如果您不想注册AID，则可以在专有范围内自由使用AID：第一个字节的第8-5位必须各设置为“1”。例如，“0xF00102030405”是专有的AID。如果确实使用专有AID，则建议选择至少6个字节的AID，以降低与可能使用专有AID的其他应用程序发生冲突的风险。

AID groups

在某些情况下，服务可能需要注册多个AID来实现某个应用程序，并且需要确定它是所有这些AID的默认处理程序（而不是组中的某些AID转到其他服务）。

一个AID组是应该被OS视为一起归属的AID列表。对于AID组中的所有AID，操作系统将保证以下之一：

All AIDs in the group are routed to this service
No AIDs in the group are routed to this service

In other words, there is no in-between state, where some AIDs in the group can be routed to this service, and some to another.

AID groups and categories

每个AID组都可以与一个类别关联。这允许Android OS对服务进行分类，并允许用户在类别级别而不是AID级别设置默认值。

您可以使用 isDefaultServiceForCategory(android.content.ComponentName, String)来确定您的服务是否是某个类别的默认处理程序。

在这个版本的平台中，唯一已知的类别是CATEGORY_PAYMENT和CATEGORY_OTHER 。没有类别的AID组或者当前平台版本无法识别的类别将自动分组到CATEGORY_OTHER类别中。

Service AID registration

为了告知平台哪些AIDs组被这个服务请求，一个SERVICE_META_DATA条目必须包含在服务声明中。 HostApduService清单声明的示例如下所示：

 <service android:name=".MyHostApduService" android:exported="true" android:permission="android.permission.BIND_NFC_SERVICE">
     <intent-filter>
         <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
     </intent-filter>
     <meta-data android:name="android.nfc.cardemulation.host_apdu_ervice" android:resource="@xml/apduservice"/>
 </service>

This meta-data tag points to an apduservice.xml file. An example of this file with a single AID group declaration is shown below:

 <host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
           android:description="@string/servicedesc" android:requireDeviceUnlock="false">
       <aid-group android:description="@string/aiddescription" android:category="other">
           <aid-filter android:name="F0010203040506"/>
           <aid-filter android:name="F0394148148100"/>
       </aid-group>
 </host-apdu-service>

<host-apdu-service>需要包含<android:description>属性，其中包含可能在UI中显示的用户友好的服务说明。可以使用<requireDeviceUnlock>属性指定在调用此服务来处理APDU之前必须先解锁设备。

<host-apdu-service>必须包含一个或多个<aid-group>标签。每个<aid-group>必须包含一个或多个<aid-filter>标签，每个标签包含一个AID。 AID必须以十六进制格式指定，并且包含偶数个字符。

AID conflict resolution

Multiple HostApduServices may be installed on a single device, and the same AID can be registered by more than one service. The Android platform resolves AID conflicts depending on which category an AID belongs to. Each category may have a different conflict resolution policy. For example, for some categories the user may be able to select a default service in the Android settings UI. For other categories, to policy may be to always ask the user which service is to be invoked in case of conflict. To query the conflict resolution policy for a certain category, see getSelectionModeForCategory(String).

Data exchange

一旦平台将“SELECT AID”命令APDU解析为特定服务组件，“SELECT AID”命令APDU和所有后续命令APDU将通过 processCommandApdu(byte[], Bundle)发送到该服务，直到：

The NFC link is broken
A "SELECT AID" APDU is received which resolves to another service

These two scenarios are indicated by a call to onDeactivated(int).

使用此类需要 FEATURE_NFC_HOST_CARD_EMULATION在设备上。

Summary

Constants
`int`	`DEACTIVATION_DESELECTED` 原因为 `onDeactivated(int)` 。
`int`	`DEACTIVATION_LINK_LOSS` 原因为 `onDeactivated(int)` 。
`String`	`SERVICE_INTERFACE` 必须声明为由服务处理的 `Intent`操作。
`String`	`SERVICE_META_DATA` 包含有关此服务的更多信息的元数据元素的名称。

Inherited constants

From class android.app.Service

From class android.content.Context

From interface android.content.ComponentCallbacks2

Public constructors
`HostApduService()`

Public methods
`final void`	`notifyUnhandled()` 调用此方法允许服务告诉操作系统它将无法完成此事务 - 例如，因为它需要当时不存在的数据连接。
`final IBinder`	`onBind(Intent intent)` 将通信信道返回给服务。
`abstract void`	`onDeactivated(int reason)` 这种方法将在两种可能的情况下被调用： The NFC link has been deactivated or lost A different AID has been selected and was resolved to a different service component
`abstract byte[]`	`processCommandApdu(byte[] commandApdu, Bundle extras)` 当从远程设备接收到命令APDU时，将调用此方法。
`final void`	`sendResponseApdu(byte[] responseApdu)` 将响应APDU发送回远程设备。

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)` 将新的 `ComponentCallbacks`添加到Context的基本应用程序中，将在与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

DEACTIVATION_DESELECTED

Added in API level 19

int DEACTIVATION_DESELECTED

原因为 onDeactivated(int) 。

指示取消激活是由于选择了不同的AID（隐式取消选择当前在逻辑通道上激活的AID）。

请注意，这个下一个AID仍然可以解析为此服务，在这种情况下 processCommandApdu(byte[], Bundle)将再次被调用。

常数值：1（0x00000001）

DEACTIVATION_LINK_LOSS

Added in API level 19

int DEACTIVATION_LINK_LOSS

原因为onDeactivated(int) 。表示取消激活是由于NFC链路丢失。

常量值：0（0x00000000）

SERVICE_INTERFACE

Added in API level 19

String SERVICE_INTERFACE

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

常量值：“android.nfc.cardemulation.action.HOST_APDU_SERVICE”

SERVICE_META_DATA

Added in API level 19

String SERVICE_META_DATA

包含有关此服务的更多信息的元数据元素的名称。

常量值：“android.nfc.cardemulation.host_apdu_service”

Public constructors

HostApduService

Added in API level 19

HostApduService ()

Public methods

notifyUnhandled

Added in API level 19

void notifyUnhandled ()

调用此方法允许服务告诉操作系统它将无法完成此事务 - 例如，因为它需要当时不存在的数据连接。操作系统可以使用该指示为用户提供可以处理所选择的最后AID的替代应用程序的列表。如果用户从列表中选择应用程序，则该操作本身不会导致默认值被更改; 所选的应用程序将只为下一次点击而被调用。如果没有其他应用程序可以处理此事务，则操作系统将显示一个错误对话框，指出您的服务无法完成该事务。

注意：可以在第一个 processCommandApdu(byte[], Bundle)调用和 onDeactivated(int)调用之间的任何地方调用此方法。

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.

onDeactivated

Added in API level 19

void onDeactivated (int reason)

这种方法将在两种可能的情况下被调用：

The NFC link has been deactivated or lost

A different AID has been selected and was resolved to a different service component

Parameters
`reason`	`int`: Either `DEACTIVATION_LINK_LOSS` or `DEACTIVATION_DESELECTED`

processCommandApdu

Added in API level 19

byte[] processCommandApdu (byte[] commandApdu, 
                Bundle extras)

当从远程设备接收到命令APDU时，将调用此方法。响应APDU可以通过在此方法中返回字节数组直接提供。请注意，一般来说，响应APDU必须尽可能快地发送，因为当调用此方法时，用户可能将他的设备通过NFC读取器。

如果有多个服务在其元数据条目中注册了相同的AID，则只有在用户明确选择了服务时才会被调用，无论是默认还是仅用于下一次点击。

此方法在您的应用程序的主线程上运行。如果您无法立即返回响应APDU，请返回null并稍后使用sendResponseApdu(byte[])方法。

Parameters
`commandApdu`	`byte`: The APDU that was received from the remote device
`extras`	`Bundle`: A bundle containing extra data. May be null.

Returns
`byte[]`	a byte-array containing the response APDU, or null if no response APDU can be sent at this point.

sendResponseApdu

Added in API level 19

void sendResponseApdu (byte[] responseApdu)

将响应APDU发送回远程设备。

注意：这个方法可以从任何线程调用并且不会被阻塞。

Parameters
`responseApdu`	`byte`: A byte-array containing the reponse APDU.