Most visited

Recently visited

Results for

Added in API level 23

ConnectionService

public abstract class ConnectionService
extends Service

java.lang.Object
	android.content.Context
		android.content.ContextWrapper
			android.app.Service
				android.telecom.ConnectionService

一种抽象服务，应该由任何可以拨打电话（VoIP或其他）的应用程序实现，并且希望将这些呼叫集成到内置的电话应用程序中。一旦实施， ConnectionService需要两个额外的步骤，才能将其集成到手机应用程序中：

1. 在AndroidManifest.xml中注册

 <service android:name="com.example.package.MyConnectionService"
    android:label="@string/some_label_for_my_connection_service"
    android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
  <intent-filter>
   <action android:name="android.telecom.ConnectionService" />
  </intent-filter>
 </service>

2. 注册PhoneAccount与TelecomManager 。
有关更多信息，请参阅PhoneAccount和registerPhoneAccount(PhoneAccount) 。

一旦用户在电话应用程序设置中注册并启用，电信将绑定到ConnectionService实施，当它要求ConnectionService拨打电话或该服务已通过addNewIncomingCall(PhoneAccountHandle, Bundle)表明有来电时。然后， ConnectionService可以预期致电onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest)或onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)其中它应该提供Connection对象的新实例。正是通过这个Connection对象，电信接收状态更新并且ConnectionService接收诸如应答，拒绝，保持和断开的呼叫命令。

当不再有实时通话时，电信将从 ConnectionService解除绑定。

摘要(Summary)

常量(Constants)
`String`	`SERVICE_INTERFACE` 必须声明为由服务处理的 `Intent` 。

Inherited constants

From class android.app.Service

From class android.content.Context

From interface android.content.ComponentCallbacks2

Public constructors
`ConnectionService()`

公共方法(Public methods)
`final void`	`addConference(Conference conference)` 添加新的电话会议。
`final void`	`addExistingConnection(PhoneAccountHandle phoneAccountHandle, Connection connection)` 添加由 `ConnectionService`创建的连接并将新连接通知给电信公司。
`final void`	`conferenceRemoteConnections(RemoteConnection remoteConnection1, RemoteConnection remoteConnection2)` 指示相关的 `RemoteConnectionService`指定的 `RemoteConnection`应合并成电话会议。
`final RemoteConnection`	`createRemoteIncomingConnection(PhoneAccountHandle connectionManagerPhoneAccount, ConnectionRequest request)` 请求其他 `ConnectionService`在给定传入请求的情况下创建一个 `RemoteConnection` 。
`final RemoteConnection`	`createRemoteOutgoingConnection(PhoneAccountHandle connectionManagerPhoneAccount, ConnectionRequest request)` 要求其他 `ConnectionService`在给定传出请求的情况下创建 `RemoteConnection` 。
`final Collection<Conference>`	`getAllConferences()` 返回此 `ConnectionService`已承担责任的所有活动 `Conference` 。
`final Collection<Connection>`	`getAllConnections()` 返回此 `ConnectionService`已承担责任的所有活动 `Connection` 。
`final IBinder`	`onBind(Intent intent)` 将通信信道返回给服务。
`void`	`onConference(Connection connection1, Connection connection2)` 会议两个指定的连接。
`Connection`	`onCreateIncomingConnection(PhoneAccountHandle connectionManagerPhoneAccount, ConnectionRequest request)` 给定一个传入请求，创建一个 `Connection` 。
`Connection`	`onCreateOutgoingConnection(PhoneAccountHandle connectionManagerPhoneAccount, ConnectionRequest request)` 给出一个输出请求，创建一个 `Connection` 。
`void`	`onRemoteConferenceAdded(RemoteConference conference)` 表示已为现有的 `RemoteConnection`创建远程会议。
`void`	`onRemoteExistingConnectionAdded(RemoteConnection connection)` 当远程添加现有连接时调用。
`boolean`	`onUnbind(Intent intent)` 当所有客户端与服务发布的特定接口断开连接时调用。

继承方法(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

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

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)` 将新的 `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)

SERVICE_INTERFACE

Added in API level 23

String SERVICE_INTERFACE

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

常量值：“android.telecom.ConnectionService”

Public constructors

ConnectionService

Added in API level 23

ConnectionService ()

公共方法(Public methods)

addConference

Added in API level 23

void addConference (Conference conference)

添加新的电话会议。当通过onConference(Connection, Connection)或其他方式显式请求创建电话会议时，连接服务应通过调用此方法提供Conference的实例。此方法提供的电话会议将一直持续到会议实例调用destroy() 。

参数(Parameters)
`conference`	`Conference`: The new conference object.

addExistingConnection

Added in API level 23

void addExistingConnection (PhoneAccountHandle phoneAccountHandle, 
                Connection connection)

添加由 ConnectionService创建的连接，并通知电信新连接。

参数(Parameters)
`phoneAccountHandle`	`PhoneAccountHandle`: The phone account handle for the connection.
`connection`	`Connection`: The connection to add.

conferenceRemoteConnections

Added in API level 23

void conferenceRemoteConnections (RemoteConnection remoteConnection1, 
                RemoteConnection remoteConnection2)

向相关的 RemoteConnectionService表明应将指定的 RemoteConnection合并成电话会议。

如果会议请求成功，将调用方法 onRemoteConferenceAdded(RemoteConference) 。

参数(Parameters)
`remoteConnection1`	`RemoteConnection`: The first of the remote connections to conference.
`remoteConnection2`	`RemoteConnection`: The second of the remote connections to conference.

createRemoteIncomingConnection

Added in API level 23

RemoteConnection createRemoteIncomingConnection (PhoneAccountHandle connectionManagerPhoneAccount, 
                ConnectionRequest request)

请求其他ConnectionService根据给定的传入请求创建RemoteConnection 。这由ConnectionService s使用，它们在CAPABILITY_CONNECTION_MANAGER中注册，并希望能够管理基于SIM卡的来电。

参数(Parameters)
`connectionManagerPhoneAccount`	`PhoneAccountHandle`: See description at `onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)`.
`request`	`ConnectionRequest`: Details about the incoming call.

返回(Returns)
`RemoteConnection`	The `Connection` object to satisfy this call, or `null` to not handle the call.

createRemoteOutgoingConnection

Added in API level 23

RemoteConnection createRemoteOutgoingConnection (PhoneAccountHandle connectionManagerPhoneAccount, 
                ConnectionRequest request)

请求一些其他ConnectionService在给定传出请求的情况下创建RemoteConnection 。这被ConnectionService所使用，它们在CAPABILITY_CONNECTION_MANAGER中注册并且希望能够使用基于SIM的ConnectionService来发出其呼出。

参数(Parameters)
`connectionManagerPhoneAccount`	`PhoneAccountHandle`: See description at `onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)`.
`request`	`ConnectionRequest`: Details about the incoming call.

返回(Returns)
`RemoteConnection`	The `Connection` object to satisfy this call, or `null` to not handle the call.

getAllConferences

Added in API level 24

Collection<Conference> getAllConferences ()

返回此 ConnectionService已承担责任的所有活动 Conference 。

返回(Returns)
`Collection<Conference>`	A collection of `Conference`s created by this `ConnectionService`.

getAllConnections

Added in API level 23

Collection<Connection> getAllConnections ()

返回此 ConnectionService已承担责任的所有活动 Connection 。

返回(Returns)
`Collection<Connection>`	A collection of `Connection`s created by this `ConnectionService`.

onBind

Added in API level 23

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.

onConference

Added in API level 23

void onConference (Connection connection1, 
                Connection connection2)

会议两个指定的连接。当用户请求合并指定的连接到电话会议中时调用。作为响应，连接服务应该创建一个Conference的实例并将其传递到addConference(Conference) 。

参数(Parameters)
`connection1`	`Connection`: A connection to merge into a conference call.
`connection2`	`Connection`: A connection to merge into a conference call.

onCreateIncomingConnection

Added in API level 23

Connection onCreateIncomingConnection (PhoneAccountHandle connectionManagerPhoneAccount, 
                ConnectionRequest request)

给定一个传入请求，创建一个Connection 。这用于附加到现有的来电。

参数(Parameters)
`connectionManagerPhoneAccount`	`PhoneAccountHandle`: See description at `onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)`.
`request`	`ConnectionRequest`: Details about the incoming call.

返回(Returns)
`Connection`	The `Connection` object to satisfy this call, or `null` to not handle the call.

onCreateOutgoingConnection

Added in API level 23

Connection onCreateOutgoingConnection (PhoneAccountHandle connectionManagerPhoneAccount, 
                ConnectionRequest request)

给出一个传出请求创建一个Connection 。这用于发起新的传出呼叫。

参数(Parameters)

参数(Parameters)
`connectionManagerPhoneAccount`	`PhoneAccountHandle`: The connection manager account to use for managing this call. 如果此参数不是`null` ，则表示此`ConnectionService`已注册一个或多个`PhoneAccount`有`CAPABILITY_CONNECTION_MANAGER` 。此参数将包含这些`PhoneAccount`之一，而`request`将包含另一个（通常但不总是不同）的`PhoneAccount` ，用于实际建立连接。如果这个参数是`null` ，这意味着这个`ConnectionService`被要求直接连接。该`getAccountHandle()`参数`request`将是一个`PhoneAccount`这个注册`ConnectionService`用于建立连接。
`request`	`ConnectionRequest`: Details about the outgoing call.

connectionManagerPhoneAccount

PhoneAccountHandle: The connection manager account to use for managing this call.

如果此参数不是null ，则表示此ConnectionService已注册一个或多个PhoneAccount有CAPABILITY_CONNECTION_MANAGER 。此参数将包含这些PhoneAccount之一，而request将包含另一个（通常但不总是不同）的PhoneAccount ，用于实际建立连接。

如果这个参数是null ，这意味着这个ConnectionService被要求直接连接。该getAccountHandle()参数request将是一个PhoneAccount这个注册ConnectionService用于建立连接。

request ConnectionRequest: Details about the outgoing call.

返回(Returns)
`Connection`	The `Connection` object to satisfy this call, or the result of an invocation of `createFailedConnection(DisconnectCause)` to not handle the call.

onRemoteConferenceAdded

Added in API level 23

void onRemoteConferenceAdded (RemoteConference conference)

表示已为现有的RemoteConnection创建远程会议。当这个方法被调用时，这个ConnectionService应该创建它自己的电话会议表示并使用addConference(Conference)发送给电信。

这只与在 ConnectionService注册的 CAPABILITY_CONNECTION_MANAGER 。

参数(Parameters)
`conference`	`RemoteConference`: The remote conference call.

onRemoteExistingConnectionAdded

Added in API level 23

void onRemoteExistingConnectionAdded (RemoteConnection connection)

当远程添加现有连接时调用。

参数(Parameters)
`connection`	`RemoteConnection`: The existing connection which was added.

onUnbind

Added in API level 23

boolean onUnbind (Intent intent)

当所有客户端与服务发布的特定接口断开连接时调用。默认实现什么也不做，并返回false。

参数(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)
`boolean`	Return true if you would like to have the service's `onRebind(Intent)` method later called when new clients bind to it.