# WMPFSettingApi.setSetting
需 WMPF >= 2.1.0 支持，使用前建议阅读注意事项
设置 WMPF 选项。
WMPF 有以下选项可以设置:
| 键 | 值 | 说明 | 最低版本 |
|---|---|---|---|
| enableLeftCapsuleStyle | true, false | 是否将胶囊按钮放到左边，一般车机系统可以设置 | |
| enableSingleProcess | MOST, SINGLE, MAIN_PROCESS | 设置进程模型，分别是多进程、单进程、主进程模式 | |
| configDarkMode | 0, 1, 2 | 0: 跟随系统深色模式；1: 浅色模式；2: 深色模式 | |
| enableDarkMode | true, false | 是否开启暗黑模式。如果关闭，则无论系统是否启动暗黑模式，都为浅色模式。 | |
| enableLayoutInScreen | true, false | 浮窗小程序是否开启 FLAG_LAYOUT_IN_SCREEN | 2.4.0 移除，请使用 WMPFFloatWindowOrientationSpecific#setLayoutInScreen |
| enableKeyboardCtrl | true, false | 是否开启键盘导航 | |
| configSuspendTimeoutSeconds | 0, 1, 5, 30, 60, 300, 1800 | 小程序切后台挂起时间，挂起后的小程序的 JS 线程将被暂停 | |
| configSuicideTimeoutSeconds | -1, 0, 1, 5, 30, 60, 300, 1800 | 小程序切后台退出时间，退出后小程序的资源将被回收 | |
| configNoBackground | true, false | 开启后将清理未在运行小程序的进程 | |
| configUIZoom | 0.5, 0.75, 1.0, 1.25, 1.5, 1.75, 2.0 | 调整小程序原生 ui 的显示大小，设置后下一次启动小程序生效。默认 1.0 | |
| configUIRatio | 正数 | 竖屏小程序的窗口高宽比 | |
| configUIReverseLandscape | true, false | 是否将小程序画面旋转 180 度，默认为 false | |
| configCapsuleCompatModeScale | 正数 | 竖屏小程序的窗口高宽比 | |
| configCapsuleScale | 正数 | 竖屏小程序的窗口高宽比 | |
| configMaxMemorySize | 正数 | WMPF 内存上限，如果 WMPF 内存超过该上限，尝试杀小程序。 | |
| configMaxContainerLimit | 1, 2, 3, 4, 5 | 小程序进程数目上限，若设置 enableSingleProcess=MOST，则可以控制小程序 container 进程数目。注意小程序个数和小程序进程数目没有必然关联，该设置项不能用于限制小程序个数，请使用 configMaxMiniProgramProcesLimit | 2.3.0 |
| configMaxMiniProgramProcessLimit | 正数 | 小程序数目上限。小程序运行数量超限时，将尝试杀掉不需要后台存活的小程序，保留需要在后台运行小程序智能助手、播放背景音频的小程序。 | 2.4.0 |
| configKeepAliveWhenLoggingOut | true, false | 小程序是否可以调用 wmpf.logout() 接口登出小程序微信用户登录且保留小程序的继续运行。默认情况下用户登出后小程序将被杀死。 | 2.4.0 |
| configDrivingMaskAllowList | 正数 | 选择小程序走行规制的屏蔽范围，建议通过 WMPFUiApi.setDrivingMaskAllowList 控制。 | 2.4.0 |
| openVoiceUsbCameraName | String | 要使用 USB 摄像头的名称 | |
| openVoiceUsbCameraProductId | int | 要使用 USB 摄像头的 productId | |
| openVoiceUsbCameraVendorId | int | 要使用 USB 摄像头的 vendorId | |
| openVoiceUsbCameraSerialNumber | string | 要使用 USB 摄像头的 serialNumber | |
| openVoiceUsbCameraRotationAngle | 0, 90, 180, 270 | USB 摄像头预览和推流画面显示时的旋转角度，默认为 0 | |
| openVoiceUsbCameraPushFlip | true, false | 系统摄像头推流画面是否旋转 180 | |
| openVoiceInternalCameraName | string | 指定要使用的内置摄像头的 cameraId（从安卓系统获取到的 cameraId），未传入时则自动选择摄像头 | |
| openVoiceInternalCameraPushFlip | true, false | 系统摄像头推流画面是否旋转 180 | |
| openVoiceInternalCameraRotationAngle | 0, 90, 180, 270 | 系统摄像头推流画面的旋转角度，默认为 0 |
关于摄像头参数的说明
- 指定 USB 摄像头名称可以使用
openVoiceUsbCameraName，或openVoiceUsbCameraProductId + openVoiceUsbCameraVendorId + openVoiceUsbCameraSerialNumber，两种方式二选一即可。仅在指定 USB 摄像头的情况下，才会使用 USB 摄像头，其他情况下会使用系统摄像头。 - 指定内置摄像头可以使用
openVoiceInternalCameraName传入从安卓系统获取到的 cameraId。 - 使用 USB 摄像头时，需使用
openVoiceUsbCameraPushFlip和openVoiceUsbCameraRotationAngle设置画面旋转 - 使用系统摄像头时，需使用
openVoiceInternalCameraPushFlip和openVoiceInternalCameraRotationAngle设置画面旋转，指定usb开头的配置项无效。 - 预览画面是指当前设备看到的摄像头拍到的画面，推流画面是指微信客户端内看到的当前设备拍摄的画面。
- 使用系统摄像头时，预览画面的方向是系统 API 提供的，不支持调整。
# 调用参数
| 参数 | 类型 | 说明 | 最低版本 |
|---|---|---|---|
| key | String | 键 | |
| value | String | 值 |
# 返回参数
无
# 示例代码
val settingApi = WMPF.getInstance().getSettingApi()
settingApi.setSetting("key", "value")