# 技术信息

# 权限、设备使用列表

权限	场景	说明
android.permission.WAKE_LOCK	阻止系统休眠	保持微信native层网络组件需要。防止网络请求进行中被休眠/屏幕息屏打断。发起网络请求时获取WAKE_LOCK, 请求结束后释放。必须
android.permission.ALARM_LOCK	ALARM_LOCK	ALARM_LOCK
android.permission.ACCESS_COARSE_LOCATION	通过网络得到粗略位置	允许小程序访问位置时使用：小程序定位接口、地图组件等 对于后台定位权限，小程序需要在其app.json内声明其需要后台定位权限
android.permission.ACCESS_FINE_LOCATION	通过 GPS 得到精确位置
android.permission.ACCESS_BACKGROUND_LOCATION	后台获取位置信息
android.permission.READ_EXTERNAL_STORAGE	读取小程序存储	框架需要读写日志、小程序存储 等信息至 getExternalFilesDir 位置，如 /storage/emulated/0/Android/data/com.tencent.wmpf。
android.permission.WRITE_EXTERNAL_STORAGE	保存日志、写入小程序存储
android.permission.ACCESS_NETWORK_STATE	检测网络的可用性. 需要网络运营商相关信息用于网络定位	允许程序访问当前网络状态
android.permission.CHANGE_NETWORK_STATE	访问网络的变化, 需要某些信息用于网络定位.网络状态恢复时重启下载任务	改变网络状态如是否能联网
android.permission.ACCESS_WIFI_STATE	访问WiFi状态.	获取当前WiFi接入的状态以及WLAN热点的信息，允许小程序访问WiFi 接口
android.permission.CHANGE_WIFI_STATE	发起WiFi扫描, 需要WiFi信息用于网络定位
android.permission.CHANGE_WIFI_MULTICAST_STATE	获取局域网内其他设备或服务	投屏
android.permission.INTERNET	访问网络, 必须	小程序需要网络才能运行
android.permission.RECORD_AUDIO	语音输入场景, VOIP通话场景s	允许小程序调用录制音频、实时音视频、多人音视频对话等
android.permission.BLUETOOTH	小程序与蓝牙设备配对并通信	允许小程序访问蓝牙/BLE接口等
android.permission.BLUETOOTH_ADMIN	小程序与蓝牙设备配对并通信
android.permission.CAMERA	相机	允许小程序调用扫一扫、摄像头组件、实时音视频录制组件、多人音视频对话组件等 如小程序可以通过摄像头扫描二维码、识别文本、拍照、识别物体等。 WMPF 内可以通过 Camera、Camera2 接口访问摄像头。 车机场景默认屏蔽摄像头权限。
android.permission.VIBRATE	使 Android 设备短暂或较长时间震动	允许小程序调用短时震动、长时震动
android.permission.NFC	近场通信 NFC	允许小程序调用 NFC 接口
android.permission.MODIFY_AUDIO_SETTINGS	修改全局音频设置	修改全局音频设置、多人音视频对话组件
android.permission.SYSTEM_ALERT_WINDOW	悬浮窗权限	框架需要系统悬浮窗权限才能通过悬浮窗模式打开小程序
android.permission.FOREGROUND_SERVICE	通过前台服务进行调用导航、录音、摄像头等功能, 必须	由于悬浮窗小程序不被系统认为是前台应用，需要前台服务权限允许悬浮窗小程序调用前台定位、录音、摄像头等权限
android.car.permission.CAR_CONTROL_AUDIO_VOLUME	设置音量	允许用户划动小程序视频播放组件时调节音量。无此权限时将回退到 AudioManager 相关接口控制音量。

# 必须预先授予的权限

以下是系统须预先授权 WMPF 应用的权限：

# Android Car API 使用列表

# 定位方式

目前 WMPF 会调用以下接口获取系统定位信息

服务	方法
LocationManager GPS 定位	requestLocationUpdates
	registerGnssStatusCallback
	getLastKnownLocation
	isProivderEnabled
TelephonyManager 基站定位	getAllCellInfo
	getCellLocation
	requestCellInfoUpdate
	getSimState
	listen
WifiManager 室内定位	isWifiEnabled
	isScanAlwaysAvailable
	getScanResults
	startScan
	getWifiState

# 匿名 Intent 使用列表

# 其他技术信息

# 域名名单

注意：由于框架层无法控制小程序访问的域名列表，接入方需要自行测算小程序访问的域名列表并予以设置白名单

对于部分使用物联网卡的设备，需要设置域名白名单，以下是 WMPF 框架层使用的域名白名单：

# 音频播放

利用系统解码器，解码后通过 AudioTrack 接口播放。音频播放的采样率、音频格式均由小程序开发者决定。StreamType 默认为 AudioManager.STREAM_MUSIC。

音频焦点抢占逻辑：

• 对于背景音频，其他应用抢占音频焦点后，背景音频将暂停播放。WMPF 重新获得焦点后，将继续播放背景音频。
• 对于游戏音频和应用内调用 wx.createInnerAudioContext 接口播放的音频，小程序开发者可以选择在丢失音频焦点后混播或者暂停音频播放。框架不限制混播（如车机蓝牙电话和游戏音频混播）。

# 是否自带输入法？

小程序 <input> 组件需要输入身份号码、纯数字键盘时，会使用 WMPF 内置的数字键盘。

# OpenGL ES

WMPF 需要 OpenGL ES 以支持小程序 webview、小游戏、小程序 canvas 渲染。

# 存储空间

WMPF 存储空间主要由以下几部分组成，提供给 WMPF 的存储空间要在 2G 以上：

• 小程序代码包、编译缓存
• 小程序自身数据缓存、图片缓存
• 小程序自身数据存储
• XWeb 浏览器内核

其中存储空间会和用户使用过的小程序数目、时长有关，没有上限。

你可以通过 WMPF.getInstance().trimStorage 接口来按需清理 WMPF 存储空间。需要注意如果清理小程序代码包，会因为重新下载必要的小程序代码包而增大下载小程序代码包产生的流量消耗。

# 流量消耗

WMPF 网络请求主要由以下几部分组成：

• 小程序桌面列表、小程序图标、微信登录
• 小程序代码包下载
• 小程序内图片
• 小程序自身网络请求

WMPF 可能在如下场景下，即使设备连接了 WiFi 也会使用数据流量：

• 实时音视频通话：通过数据流量改善通话体验
• 基于基站的定位

# 后台行为

WMPF 会因为但不限于以下几个场景在后台运行：

# 多用户支持

由于 WMPF 并非必须以系统应用的方式安装，WMPF 未专门支持 Android 系统的多用户能力。系统侧可以通过 Android 系统默认的多用户多进程并隔离存储空间的方式实现多用户支持。

# IPC 机制

wmpf-cli 接口通过 ContentProvider、Binder（AIDL）等方式允许接入 App 和 WMPF 进程通信。

# ContentProvider 通信列表

# Binder 通信列表

# Activity 列表

对于系统内存在车载微信的情况，WMPF 将会与车载微信通过微信 opensdk（内部通过 Activity intent）进行通信，intent 安全性由车载微信保证。

# 开源软件使用列表