Most visited

Recently visited

Results for

Added in API level 21

VoiceInteractionService

public class VoiceInteractionService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.service.voice.VoiceInteractionService

目前全球语音互动，这是提供hotwording支持的顶级服务，的后端 VoiceInteractor ，等等。当前VoiceInteractionService已经由用户选择保持总是由系统中运行，它允许做一些事情，比如倾听背景中的热词来鼓动语音交互。

由于此服务始终在运行，因此应尽可能保持轻量级。当实际的语音交互发生时，应该在关联的VoiceInteractionSessionService实现重量级操作（包括显示UI），并且该服务应该在与此服务分开的过程中运行。

Summary

Constants
`String`	`SERVICE_INTERFACE` 必须声明为由服务处理的 `Intent` 。
`String`	`SERVICE_META_DATA` VoiceInteractionService组件发布有关其自身的信息的名称。

Inherited constants

From class android.app.Service

From class android.content.Context

From interface android.content.ComponentCallbacks2

Public constructors
`VoiceInteractionService()`

Public methods
`final AlwaysOnHotwordDetector`	`createAlwaysOnHotwordDetector(String keyphrase, Locale locale, AlwaysOnHotwordDetector.Callback callback)` 为给定的关键短语和语言环境创建一个 `AlwaysOnHotwordDetector` 。
`int`	`getDisabledShowContext()` 返回由 `setDisabledShowContext(int)`设置的值。
`static boolean`	`isActiveService(Context context, ComponentName service)` 检查给定的服务组件是否是当前活动的VoiceInteractionService。
`IBinder`	`onBind(Intent intent)` 将通信信道返回给服务。
`void`	`onCreate()` 服务第一次创建时由系统调用。
`void`	`onLaunchVoiceAssistFromKeyguard()` 当用户启动键盘启动来自键盘的语音帮助时调用。
`void`	`onReady()` 在服务初始化过程中调用，告诉您系统何时准备好接收来自它的交互。
`void`	`onShutdown()` 在服务取消初始化过程中调用以告诉您系统何时关闭服务。
`void`	`setDisabledShowContext(int flags)` 设置您始终希望在显示会话时禁用的上下文选项。
`void`	`showSession(Bundle args, int flags)` 请求向用户显示关联的 `VoiceInteractionSession` ，如有必要，启动它。

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`授予特定权限，则抛出 `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

SERVICE_INTERFACE

Added in API level 21

String SERVICE_INTERFACE

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

常量值：“android.service.voice.VoiceInteractionService”

SERVICE_META_DATA

Added in API level 21

String SERVICE_META_DATA

VoiceInteractionService组件发布有关其自身的信息的名称。这个元数据应该引用包含<voice-interaction-service>标签的XML资源。

常量值：“android.voice_interaction”

Public constructors

VoiceInteractionService

Added in API level 21

VoiceInteractionService ()

Public methods

createAlwaysOnHotwordDetector

Added in API level 21

AlwaysOnHotwordDetector createAlwaysOnHotwordDetector (String keyphrase, 
                Locale locale, 
                AlwaysOnHotwordDetector.Callback callback)

为给定的关键短语和语言环境创建一个AlwaysOnHotwordDetector 。这个实例必须被客户保留和使用。再次调用这个函数会使之前创建的不再用于管理识别的热门词典检测器失效。

Parameters
`keyphrase`	`String`: The keyphrase that's being used, for example "Hello Android".
`locale`	`Locale`: The locale for which the enrollment needs to be performed.
`callback`	`AlwaysOnHotwordDetector.Callback`: The callback to notify of detection events.

Returns
`AlwaysOnHotwordDetector`	An always-on hotword detector for the given keyphrase and locale.

getDisabledShowContext

Added in API level 23

int getDisabledShowContext ()

返回 setDisabledShowContext(int)设置的值。

Returns
`int`

isActiveService

Added in API level 21

boolean isActiveService (Context context, 
                ComponentName service)

检查给定的服务组件是否是当前活动的VoiceInteractionService。

Parameters
`context`	`Context`
`service`	`ComponentName`

Returns
`boolean`

onBind

Added in API level 21

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.

onCreate

Added in API level 21

void onCreate ()

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

onLaunchVoiceAssistFromKeyguard

Added in API level 23

void onLaunchVoiceAssistFromKeyguard ()

当用户启动键盘启动来自键盘的语音帮助时调用。

只有在VoiceInteractionService设置了 supportsLaunchVoiceAssistFromKeyguard并显示键盘 supportsLaunchVoiceAssistFromKeyguard ，才会调用此方法。

有效的实施必须启动一个新的活动，该活动应使用 FLAG_SHOW_WHEN_LOCKED在锁定屏幕上显示。

onReady

Added in API level 21

void onReady ()

在服务初始化过程中调用，告诉您系统何时准备好接收来自它的交互。通常你应该在这里进行初始化，而不是在onCreate() 。诸如showSession(Bundle, int)和createAlwaysOnHotwordDetector(String, Locale, AlwaysOnHotwordDetector.Callback)方法在此之前不会运行。

onShutdown

Added in API level 21

void onShutdown ()

在服务取消初始化过程中调用以告诉您系统何时关闭服务。此时此服务可能不再是活跃的VoiceInteractionService 。

setDisabledShowContext

Added in API level 23

void setDisabledShowContext (int flags)

设置您始终希望在显示会话时禁用的上下文选项。这些标志可以是VoiceInteractionSession.SHOW_WITH_ASSIST和VoiceInteractionSession.SHOW_WITH_SCREENSHOT任意组合。

Parameters
`flags`	`int`

showSession

Added in API level 23

void showSession (Bundle args, 
                int flags)

请求向用户显示关联的 VoiceInteractionSession ，如有必要，启动它。

Parameters
`args`	`Bundle`: Arbitrary arguments that will be propagated to the session.
`flags`	`int`: Indicates additional optional behavior that should be performed. May be any combination of `VoiceInteractionSession.SHOW_WITH_ASSIST` and `VoiceInteractionSession.SHOW_WITH_SCREENSHOT` to request that the system generate and deliver assist data on the current foreground app as part of showing the session UI.

Protected methods

dump

Added in API level 21

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.