public abstract class PermissionRequest
extends Object
java.lang.Object | |
↳ | android.webkit.PermissionRequest |
该类定义了一个权限请求,并在Web内容请求访问受保护资源时使用。 许可请求相关事件通过onPermissionRequest(PermissionRequest)
和onPermissionRequestCanceled(PermissionRequest)
。 必须在UI线程中调用grant()
或deny()
才能响应请求。 未来版本的WebView中可能会请求新名称未在此处定义的受保护资源,即使在较旧的Android版本上运行时也是如此。 为避免无意中授予对新权限的请求,您应将想要授予的特定权限传递给grant()
,并避免编写类似以下示例的代码:
permissionRequest.grant(permissionRequest.getResources()) // This is wrong!!!See the WebView's release notes for information about new protected resources.
Constants |
|
---|---|
String |
RESOURCE_AUDIO_CAPTURE 资源属于音频捕获设备,如麦克风。 |
String |
RESOURCE_MIDI_SYSEX 资源将允许sysex消息发送到MIDI设备或从MIDI设备接收。 |
String |
RESOURCE_PROTECTED_MEDIA_ID 资源属于受保护的媒体标识符。 |
String |
RESOURCE_VIDEO_CAPTURE 资源属于视频捕获设备,如相机。 |
Public constructors |
|
---|---|
PermissionRequest() |
Public methods |
|
---|---|
abstract void |
deny() 调用此方法来拒绝请求。 |
abstract Uri |
getOrigin() 调用此方法以获取试图访问受限资源的网页的来源。 |
abstract String[] |
getResources() 调用此方法获取网页尝试访问的资源。 |
abstract void |
grant(String[] resources) 调用此方法为原点授予访问给定资源的权限。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
String RESOURCE_AUDIO_CAPTURE
资源属于音频捕获设备,如麦克风。
常量值:“android.webkit.resource.AUDIO_CAPTURE”
String RESOURCE_MIDI_SYSEX
资源将允许sysex消息发送到MIDI设备或从MIDI设备接收。 这些消息是特权操作,例如修改声音库和采样数据,甚至更新MIDI设备的固件。 如果Android设备已更新至WebView 45或更高版本,则可以在API级别21和更高版本中为此资源请求权限。
常量值:“android.webkit.resource.MIDI_SYSEX”
String RESOURCE_PROTECTED_MEDIA_ID
资源属于受保护的媒体标识符。 在用户授予此资源后,源可以使用EME API生成许可证请求。
常量值:“android.webkit.resource.PROTECTED_MEDIA_ID”
String RESOURCE_VIDEO_CAPTURE
资源属于视频捕获设备,如相机。
常量值:“android.webkit.resource.VIDEO_CAPTURE”
Uri getOrigin ()
调用此方法以获取试图访问受限资源的网页的来源。
Returns | |
---|---|
Uri |
the origin of web content which attempt to access the restricted resources. |
String[] getResources ()
调用此方法获取网页尝试访问的资源。
Returns | |
---|---|
String[] |
the array of resources the web content wants to access. |
void grant (String[] resources)
调用此方法为原点授予访问给定资源的权限。 授予的权限仅对此WebView有效。
Parameters | |
---|---|
resources |
String : the resources granted to be accessed by origin, to grant request, the requested resources returned by getResources() must be equals or a subset of granted resources. This parameter is designed to avoid granting permission by accident especially when new resources are requested by web content. |