snu.checkSystemPermissionGranted()

是否具备指定权限

检查当前应用是否已经具备指定权限。

兼容性

Web	Android
×	√

属性

名称	类型	必填	默认值	描述
permissions	Array<String>	是	-	需要检查的系统权限名称数组。

返回值

类型	必备	描述
Boolean	是	如果所有权限都已授权，返回 true，否则返回 false。

---

snu.getSystemPermissionDenied()

获取未授权的系统权限

获取指定权限中未授权的权限。

兼容性

Web	Android
×	√

属性

名称	类型	必填	默认值	描述
permissions	Array<String>	是	-	需要检查的系统权限名称数组。

返回值

类型	必备	描述
Array<String>	是	返回一个包含所有未授权权限名称的数组，如果所有权限都已授权，则返回空数组。

---

snu.requestSystemPermission()

请求系统权限

向用户请求指定的系统权限。

兼容性

Web	Android
×	√

属性

名称	类型	必填	默认值	描述
options	SnRequestSystemPermissionOptions	是	-	请求权限的配置选项。
options.permissions	Array<String>	是	-	需要请求的系统权限名称数组。
options.success	(allRight: boolean, grantedList: string[])=>void	否	-	请求权限成功时的回调函数，接受两个参数：allRight（所有权限是否都已授权）和 grantedList（已授权的权限列表）。
options.fail	(doNotAskAgain: boolean, grantedList: string[])=>void	否	-	请求权限失败时的回调函数，接受两个参数：doNotAskAgain（用户是否选择了不再询问）和 grantedList（已授权的权限列表）。

返回值

无

---

snu.gotoSystemPermissionActivity()

跳转到系统权限设置页面

跳转到操作系统的权限设置页面，以便用户可以直接在系统设置中管理应用权限。

兼容性

Web	Android
×	√

属性

名称	类型	必填	默认值	描述
permissions	Array<String>	是	-	需要用户在系统设置中管理的权限名称数组。

返回值

无

snu.requestMediaPermission()

请求媒体权限

由于 Google 对于 Android 本地读写权限的保护的不断增强，应用适配高版本 Android 往往需要进行大量兼容判断。因此，此方法集成了媒体权限请求，可根据不同的Android版本，帮助开发者快速请求相应的媒体访问权限。目前已适配 Android 12 及以下版本、Android 13、Android 14 及以上版本。

兼容性

Web	Android
×	√

属性

名称	类型	必填	默认值	描述
options	SnRequestMediaPermissionOptions	是	-	请求权限的配置选项。
options.types	Array<String>	是	-	需要请求的媒体类型，可选值为 image, video, audio。
options.success	(allRight: boolean, grantedList: string[])=>void	否	-	请求权限成功时的回调函数
options.fail	(doNotAskAgain: boolean, grantedList: string[])=>void	否	-	请求权限失败时的回调函数，接受两个参数：doNotAskAgain（用户是否选择了不再询问）和 grantedList（已授权的权限列表）。

返回值

无

---

snu.checkMediaPermission()

检查媒体权限

由于 Google 对于 Android 本地读写权限的保护的不断增强，应用适配高版本 Android 往往需要进行大量兼容判断。因此，此方法集成了媒体权限检查，可根据不同的Android版本，帮助开发者快速检查相应的媒体访问权限。目前已适配 Android 12 及以下版本、Android 13、Android 14 及以上版本。

兼容性

Web	Android
×	√

属性

无

返回值

类型	必备	描述
Boolean	是	是否所有媒体权限都已授权。