了解如何启动 Windows 设置。 本主题介绍 ms-settings: URI 方案。 使用此 URI 方案将 Windows 设置启动到特定设置页。
启动进入设置是开发隐私友好型应用的重要组成部分。 如果应用无法访问敏感资源,我们建议为用户提供指向该资源的隐私设置的便捷链接。 有关详细信息,请参阅 安全和标识。
重要 API
本主题使用了以下 Windows 运行时 (WinRT) API:
请注意,本主题中使用的 WinRT API 可用于 WinUI 和其他桌面应用。 若要详细了解如何使桌面应用能够使用 WinRT API,请参阅 在桌面应用中调用 Windows 运行时 API。
如何启动设置
若要启动 设置,请使用 ms-settings: URI 方案,如以下示例所示。
XAML 超链接控件
在此示例中,超链接 XAML 控件用于使用 ms-settings:privacy-microphone URI 启动麦克风的隐私设置页。
<!--Set Visibility to Visible when access to the microphone is denied -->
<TextBlock x:Name="LocationDisabledMessage" FontStyle="Italic"
Visibility="Collapsed" Margin="0,15,0,0" TextWrapping="Wrap" >
<Run Text="This app is not able to access the microphone. Go to " />
<Hyperlink NavigateUri="ms-settings:privacy-microphone">
<Run Text="Settings" />
</Hyperlink>
<Run Text=" to check the microphone privacy settings."/>
</TextBlock>
调用 LaunchUriAsync
或者,你的应用可以调用 LaunchUriAsync 方法来启动 设置。 此示例演示如何使用 ms-settings:privacy-webcam URI 启动到相机的隐私设置页。
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:privacy-webcam"));
bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:privacy-webcam"));
上面的代码启动相机的隐私设置页:
有关启动 URI 的详细信息,请参阅 启动 URI 的默认应用。
ms-settings: URI 方案参考资料
以下部分介绍用于打开各种设置页面的 ms-settings URI 的不同类别:
某些设置页面的可用性因 Windows 版本和 SKU 而异。 对于某些设置,URI 列还会捕获一些使用情况信息以及必须满足的任何其他要求才能使页面可用。
Accounts
| 设置页 | URI |
|---|---|
| 访问工作单位或学校 | ms-settings:工作场所 |
| 电子邮件和应用帐户 | ms-settings:电子邮件和账户 |
| 家庭和其他人 | ms-settings:其他用户 |
| Provisioning |
ms-settings:预配(仅在移动设备上可用,且仅当企业已部署预配包时) ms-settings:工作区预配(仅当企业已部署预配包时可用) |
| 修复令牌 | ms-settings:工作场所-修复令牌 |
| 设置展台 | ms-settings:分配访问权限 |
| 登录选项 |
ms-settings:登录选项 ms-settings:登录选项-动态锁 |
| 同步设置 |
ms-settings:同步 ms-settings:备份 (Windows 11 中弃用的备份页) |
| Windows随处 | ms-settings:Windows Anywhere(设备必须支持 Windows Anywhere) |
| Windows Hello 设置 |
ms-settings:登录选项-启动面部录入 ms-settings:登录选项-启动指纹录入 |
| 你的信息 | ms-settings:yourinfo |
Apps
| 设置页 | URI |
|---|---|
| 应用和功能 | ms-settings:应用功能 |
| 应用功能 |
ms-settings:appsfeatures-app(重置、管理该应用的加载项和可下载内容等) 若要使用 URI 访问此页面,请使用 ms-settings:appsfeatures-app URI 并传递应用的 包系列名称 的可选参数。 示例: ms-settings:appsfeatures-app?<PFN> |
| 网站应用 | ms-settings:appsforwebsites |
| 默认应用 |
ms-settings:defaultapps (Windows 11 版本 21H2(含 2023-04 累积更新)或 22H2(含 2023-04 累积更新)或更高版本中引入的行为。 使用应用的 URI 转义名称以下列格式追加查询字符串参数,以直接启动该应用的默认设置页: - registeredAppMachine=<应用的 URI 转义的每台计算机安装名> - registeredAppUser=<应用的 URI 转义的每个用户安装名> - registeredAUMID=<URI 转义的应用程序用户模型 ID> 有关详细信息,请参阅 “启动默认应用设置”页。 |
| 默认浏览器设置 | ms-settings:defaultbrowsersettings (在 Windows 11 中弃用) |
| 管理可选功能 | ms-settings:可选功能 |
| 离线地图 |
ms-settings:地图 ms-settings:maps-downloadmaps (下载地图) |
| 启动应用 | ms-settings:startupapps |
| 视频播放 | ms-settings:videoplayback |
控制中心
| 设置页 | URI |
|---|---|
| 控制中心 | ms-settings:controlcenter |
设备
| 设置页 | URI |
|---|---|
| 自动播放 | ms-settings:自动播放 |
| 蓝牙 | ms-settings:蓝牙 |
| 连接的设备 | ms-settings:已连接设备 |
| 默认相机 | ms-settings:camera (Windows 10 版本 1809 及更高版本中弃用的行为) |
| 相机设置 |
ms-settings:相机(此行为在 Windows 11(内部版本 22000 及更高版本)中引入)追加查询字符串参数 cameraId,并将其设置为相机设备经过 URI 转义的符号链接名称,以直接打开该相机的设置页面。 有关详细信息,请参阅 “启动相机设置”页。 |
| 鼠标和触摸板 | ms-settings:鼠标触摸板(触摸板设置仅在具有触摸板的设备上可用) |
| 笔和 Windows 墨迹 | ms-settings:笔 |
| 笔快捷按钮 | ms-settings:笔按钮 |
| 打印机和扫描仪 | ms-settings:打印机 |
| 触控 | ms-settings:触控设备 |
| Touchpad | ms-settings:devices-touchpad(仅在存在触摸板硬件时可用) |
| 文本建议 | ms-settings:设备键入硬件键盘文本建议 |
| 打字 | ms-settings:打字 |
| USB | ms-settings:usb |
| 方向盘 | ms-settings:转盘(仅当已配对 Surface Dial 设备时才可用) |
| 手机 | ms-settings:移动设备 |
易于访问
| 设置页 | URI |
|---|---|
| 音频 | ms-settings:easeofaccess-audio |
| 隐藏式字幕 | ms-settings:轻松使用-隐藏式字幕 |
| 颜色筛选器 |
ms-settings:轻松访问-颜色筛选器 ms-settings:轻松访问-颜色筛选器-自适应颜色链接 ms-settings:轻松访问-颜色筛选器-蓝光链接 |
| Display | ms-settings:轻松访问-显示 |
| 眼部控制 | ms-settings:轻松使用-眼动控制 |
| 听力设备 | ms-settings:easeofaccess-hearingaids(在 Windows 11 版本 24H2 中新增) |
| 高对比度 | ms-settings:轻松使用-高对比度 |
| 键盘 | ms-settings:轻松使用-键盘 |
| 放大镜 | ms-settings:轻松使用-放大镜 |
| 鼠标 | ms-settings:轻松使用-鼠标 |
| 鼠标指针和触摸 | ms-settings:轻松使用-鼠标指针 |
| 讲述人 |
ms-settings:轻松使用-讲述人 ms-settings:轻松使用-讲述人-是否已启用自动启动 |
| 语音 | ms-settings:辅助功能-语音识别 |
| 文本游标 | ms-settings:轻松使用-光标 |
| 视觉效果 | ms-settings:轻松使用-视觉效果 |
附加组件
| 设置页 | URI |
|---|---|
| 附加组件 | ms-settings:extras (仅当安装了具有这些设置的应用(例如由第三方安装)时可用) |
家庭组
| 设置页 | URI |
|---|---|
| 家庭组 | ms-settings:家庭组 |
游戏
| 设置页 | URI |
|---|---|
| 游戏栏 | ms-settings:游戏-游戏栏 |
| 游戏数字视频录制 (DVR) | ms-settings:游戏-GameDVR |
| 游戏模式 | ms-settings:游戏-游戏模式 |
| 全屏玩游戏 | ms-settings:quietmomentsgame |
| TruePlay | ms-settings:gaming-trueplay(自 Windows 10 版本 1809(10.0;内部版本 17763)起,此功能已从 Windows 中移除) |
| 设置页 | URI |
|---|---|
| 音频和语音 | ms-settings:全息音频 |
| 环境 | ms-settings:隐私全息环境 |
| 头戴显示设备 | ms-settings:全息头显 |
| 卸载 | ms-settings:全息管理 |
| 启动和桌面 | ms-settings:holographic-startupandesktop |
网络和互联网
| 设置页 | URI |
|---|---|
| 网络和互联网 | ms-settings:网络状态 |
| 高级设置 | ms-settings:网络-高级设置 |
| 飞行模式 |
ms-settings:网络-飞行模式 ms-settings:邻近 |
| 手机网络和 SIM 卡 | ms-settings:蜂窝网络 |
| 拨号上网 | ms-settings:网络拨号 |
| DirectAccess | ms-settings:network-directaccess (仅在启用 DirectAccess 时才可用) |
| 以太网 | ms-settings:网络-以太网 |
| 管理已知网络 | ms-settings:网络-Wi‑Fi设置 |
| 移动热点 | ms-settings:网络-移动热点 |
| 代理 | ms-settings:网络代理 |
| VPN | ms-settings:网络-VPN |
| WLAN | ms-settings:network-wifi (仅当设备具有 wifi 适配器时才可用) |
| Wi-Fi 预配 | ms-settings:Wi‑Fi 配网 |
个性化
| 设置页 | URI |
|---|---|
| 背景 | ms-settings:个性化背景 |
| 选择“开始”屏幕上显示的文件夹 | ms-settings:个性化起始位置 |
| 颜色 |
ms-settings:个性化-颜色 ms-settings:颜色 |
| 自定义键盘上的 Copilot 键 | ms-settings:个性化-文本输入-Copilot-硬件键 |
| 动态照明 | ms-settings:个性化照明 |
| 字体 | ms-settings:字体 |
| 概览 | ms-settings:个性化概览(在 Windows 10 版本 1809 及更高版本中已弃用) |
| 锁屏 | ms-settings:锁屏界面 |
| 导航栏 | ms-settings:个性化-导航栏(Windows 10版本 1809 及更高版本中已弃用) |
| 个性化(类别) | ms-settings:个性化 |
| Start | ms-settings:personalization-start |
| Taskbar | ms-settings:任务栏 |
| 文本输入 | ms-settings:个性化-文本输入 |
| 触摸键盘 | ms-settings:个性化-触摸键盘 |
| 主题 | ms-settings:主题 |
电话
| 设置页 | URI |
|---|---|
| 电话链接 |
ms-settings:移动设备 ms-settings:移动设备-添加手机 ms-settings:mobile-devices-addphone-direct (打开 手机链接 应用) |
| 设备使用情况 | ms-settings:设备使用情况 |
隐私
| 设置页 | URI |
|---|---|
| 附属应用 | ms-settings:privacy-accessoryapps (在 Windows 10 版本 1809 及更高版本中弃用) |
| 帐户信息 | ms-settings:隐私-账户信息 |
| 活动历史记录 | ms-settings:隐私-活动历史记录 |
| 广告识别码 | ms-settings:privacy-advertisingid (在 Windows 10 版本 1809 及更高版本中弃用) |
| 应用诊断 | ms-settings:隐私-应用诊断 |
| 自动文件下载 | ms-settings:隐私-自动文件下载 |
| 后台应用 |
ms-settings:privacy-backgroundapps (在 Windows 11、21H2 及更高版本中弃用) 注意: 在 Windows 11 中,将单独访问后台应用权限。 若要查看权限,请转到“应用已安装的应用>”,然后在新式应用上选择“...”,然后选择“高级”选项。 新式应用中会提供高级页面,并且除非设置了组策略或设置了用户的全局开关值(这是 Windows 10 中曾使用但已弃用的设置),否则“后台应用权限”部分将会显示。 若要使用 URI 访问此页面,请使用 ms-settings:appsfeatures-app URI 并传递应用的 包系列名称 的可选参数。 |
| 背景空间感知 | ms-settings:隐私-背景空间感知 |
| 日历 | ms-settings:隐私-日历 |
| 呼叫历史记录 | ms-settings:隐私-通话记录 |
| Camera | ms-settings:privacy-webcam |
| 联系人 | ms-settings:隐私联系人 |
| 文档 | ms-settings:隐私文档 |
| 下载文件夹 | ms-settings:隐私-下载文件夹 |
| ms-settings:隐私邮箱 | |
| 眼动跟踪器 | ms-settings:privacy-eyetracker(需要眼动追踪器硬件) |
| 反馈和诊断 | ms-settings:隐私反馈 |
| 文件系统 | ms-settings:隐私 - 广泛文件系统访问 |
| 概况 | ms-settings:隐私或 ms-settings:隐私常规 |
| 图形 |
ms-settings:隐私-以编程方式捕获图形 ms-settings:隐私-无边框图形捕获 |
| 墨迹书写和键入 | ms-settings:隐私-语音输入 |
| 位置 | ms-settings:隐私-位置 |
| Messaging | ms-settings:隐私消息 |
| 麦克风 | ms-settings:隐私麦克风 |
| Motion | ms-settings:隐私动态 |
| 音乐库 | ms-settings:隐私-音乐资料库 |
| Notifications | ms-settings:隐私通知 |
| 其他设备 | ms-settings:隐私-自定义设备 |
| 电话联络 | ms-settings:隐私-通话 |
| 图片 | ms-settings:隐私图片 |
| 收音机 | ms-settings:隐私单选按钮 |
| 语音 | ms-settings:隐私语音 |
| Tasks | ms-settings:隐私任务 |
| Videos | ms-settings:隐私-视频 |
| 语音激活 | ms-settings:隐私-语音激活 |
搜寻
| 设置页 | URI |
|---|---|
| 搜寻 | ms-settings:搜索 |
| 搜索更多详细信息 | ms-settings:搜索-更多详细信息 |
| 搜索权限 | ms-settings:搜索-权限 |
Sound
| 设置页 | URI |
|---|---|
| 音量混音器 | ms-settings:apps-volume |
| Sound | ms-settings:声音 |
| 声音设备 | ms-settings:音频设备 |
| 默认麦克风 | ms-settings:声音-默认输入属性 |
| 默认音频输出 | ms-settings:声音-默认输出属性 |
| 音频设备属性 (特定设备) |
ms-settings:sound-properties?endpointId={0.0.0.00000000}.{aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb} 注意: URI 的用户必须知道 endpointId 要使用的字符串。 |
| 音频设备属性 (特定设备) |
ms-settings:sound-properties?interfaceId=\\?\SWD#MMDEVAPI#{3.0.0.00000003}.{bbbbbbbb-1111-2222-3333-cccccccccccc}#{cccccccc-2222-3333-4444-dddddddddddd} 注意:URI 用户必须知道要使用的 interfaceId 字符串,且该字符串在发送前必须正确转义。 |
System
| 设置页 | URI |
|---|---|
| About | ms-settings:关于 |
| 高级显示设置 |
ms-settings:显示-高级 注意:在Windows 11,此 URI 将打开“系统>显示设置”页;“高级显示”视图是“显示”的子部分,没有专用 URI。 |
| 电池省电模式 | ms-settings:batterysaver (仅适用于具有电池的设备,如平板电脑) |
| 节电模式设置 | ms-settings:省电模式设置(仅适用于带电池的设备,如平板电脑) |
| 电池使用 | ms-settings:batterysaver-usagedetails (仅适用于具有电池的设备,如平板电脑) |
| 剪贴板 | ms-settings:剪贴板 |
| 默认保存位置 | ms-settings:保存位置 |
| Display |
ms-settings:显示 ms-settings:屏幕旋转 |
| 复制我的屏幕 | ms-settings:quietmomentspresentation |
| 在这些小时内 | ms-settings:已安排静默时段 |
| Encryption | ms-settings:设备加密 |
| 能源建议 | ms-settings:能源建议 (在 2 月的 Windows 11 版本 22H2 Moment 更新(内部版本 22624 或更高版本)中提供) |
| 专注助手 | ms-settings:免打扰时段 |
| 图形设置 | ms-settings:display-advancedgraphics (仅适用于支持高级图形选项的设备) |
| 图形默认设置 | ms-settings:显示-高级图形-默认 |
| 多任务处理 |
ms-settings:多任务处理 ms-settings:multitasking-sgupdate |
| 夜灯设置 | ms-settings:夜灯 |
| 投影到此电脑 | ms-settings:项目 |
| 共享体验 | ms-settings:crossdevice |
| 平板电脑模式 | ms-settings:tabletmode (在 Windows 11 中删除) |
| Taskbar | ms-settings:任务栏 |
| 通知和操作 | ms-settings:通知 |
| 远程桌面 | ms-settings:远程桌面 |
| 电话 | ms-settings:电话 (在 Windows 10 版本 1809 及更高版本中已弃用) |
| 电源和睡眠 | ms-settings:高效睡眠 |
| 存在感知 | ms-settings:存在感知(在 Windows 11 版本 22H2、内部版本 22624 的 5 月 Moment 更新中添加) |
| 存储 | ms-settings:storagesense |
| 存储感知 | ms-settings:存储策略 |
| 存储建议 | ms-settings:存储建议 |
| 磁盘和卷 | ms-settings:磁盘和卷 |
时间和语言
| 设置页 | URI |
|---|---|
| 日期和时间 | ms-settings:日期和时间 |
| 日本 IME 设置 | ms-settings:regionlanguage-jpnime (如果安装了 Microsoft Japan 输入法编辑器,则可用) |
| 区域 | ms-settings:区域格式 |
| 语言 |
ms-settings:键盘 ms-settings:键盘-高级 ms-settings:区域语言 ms-settings:regionlanguage-bpmfime ms-settings:regionlanguage-cangjieime ms-settings:regionlanguage-chsime-wubi-udp ms-settings:regionlanguage-quickime ms-settings:regionlanguage-korime |
| Pinyin IME 设置 |
ms-settings:regionlanguage-chsime-pinyin(仅当已安装 Microsoft Pinyin 输入法编辑器时可用) ms-settings:regionlanguage-chsime-pinyin-domainlexicon ms-settings:regionlanguage-chsime-pinyin-keyconfig ms-settings:regionlanguage-chsime-pinyin-udp |
| 语音 | ms-settings:语音 |
| Wubi IME 设置 | ms-settings:regionlanguage-chsime-wubi (如果安装了 Microsoft Wubi 输入法编辑器可用) |
更新和安全性
| 设置页 | URI |
|---|---|
| 激活 | ms-settings:激活 |
| 备份 | ms-settings:备份(Windows 11中删除的页面;打开同步) |
| 交付优化 |
ms-settings:delivery-optimization ms-settings:delivery-optimization-activity ms-settings:delivery-optimization-advanced |
| 查找我的设备 | ms-settings:查找我的设备 |
| 面向开发人员 | ms-settings:开发人员 |
| 恢复 | ms-settings:恢复 |
| 启动安全密钥注册 | ms-settings:登录选项-启动安全密钥注册 |
| Troubleshoot | ms-settings:排查故障 |
| Windows 安全 | ms-settings:windowsdefender |
| Windows 预览体验计划 |
ms-settings:Windows Insider(仅当用户已加入 WIP 时才会显示) ms-settings:windowsinsider-optin |
| Windows 更新 |
ms-settings:windowsupdate ms-settings:windowsupdate-action |
| Windows 更新 - 活跃时间 | ms-settings:Windows 更新 - 活动时间 |
| Windows 更新-高级选项 | ms-settings:Windows 更新选项 |
| Windows 更新-可选更新 | ms-settings:Windows 更新-可选更新 |
| Windows 更新-重启选项 | ms-settings:Windows 更新-重启选项 |
| 按需 Windows 更新查找器 | ms-settings:windowsupdate-seekerondemand |
| Windows 更新-查看更新历史记录 | ms-settings:Windows 更新历史记录 |