需要查找本主题的 IT 专业人员版本? 请参阅自定义 Windows 11“开始”菜单布局
Tip
若要获取本主题的 Windows 10 版本,请参阅自定义 Windows 10“开始”菜单布局
OEM 可以自定义 Windows 11“开始”菜单布局,以便将 OEM 定义的项(应用和/或网站)固定在“开始”菜单中的特定区域。
使用 LayoutModification.json 开始布局自定义,包括网站固定的配置。
Note
不能使用 Windows 配置设计器或 Unattend 文件来配置 Windows 11“开始”菜单。
“开始”菜单部分
“开始”菜单由三个部分组成:“已固定项”、“所有应用”和“建议”。 LayoutModification.json 可以包含“已固定项”和/或“建议”部分的自定义项。
Pinned section
“开始”菜单顶部的部分名为“已固定项”部分。 此部分由网格中排列的固定应用组成。 此部分中的项是电脑上安装的所有应用中的一部分;此部分默认不会包含所有已安装的应用。 无论设备面板大小如何,此视图中的行数和项数都保持一致。
虽然此部分的初始视图显示 18 个项,但用户可以使用分页控件来浏览其他固定应用的页面。 此部分中的项是 Microsoft 定义的应用、动态交付的应用和 OEM 配置项的组合。 设置电脑后,用户可以在此部分中添加、移动或删除固定应用。
Available customizations:
- 此部分的第 1 页最多包含四个项。 在 LayoutModification.json 中使用
primaryOEMPins进行配置。 - 已固定应用网格底部最多包含四个项。 用户需要在“开始”菜单中向下滚动才能看到这些固定应用。 在 LayoutModification.json 中使用
secondaryOEMPins进行配置。
如果在其中任一部分中固定四个以下的项,则 Microsoft 定义的其他应用将会滑动,以填充空白空间来保持相同的顺序。 将忽略前四个数组元素以外的任何数组元素。
Note
一个项只能在“已固定项”部分中显示一次。 在此部分,无法将应用固定在多个位置,不管是固定在相同还是不同的页面上。
“所有应用”部分
当用户单击“开始”菜单右上角的“所有应用”时,就会显示此部分。 “所有应用”是按字母顺序列出的所有已安装应用的综合列表。
可用定制选项:此部分没有定制选项。 “所有应用”是一个包含所有已安装应用的列表,不能由用户或 OEM 自定义。
应用分类:应用分类即将进入“开始”菜单。
Note
如果你是应用程序开发人员,并且应用程序未置于“开始”菜单上的正确类别中,请按照下面的相应步骤作。
- 如果你位于欧盟,则可以按照 Microsoft 应用商店载入过程 将应用程序加入到 Microsoft 应用商店,并指定相应的类别,也可以通过电子邮件发送 应用程序分类支持 ,并提供应用程序名称、可执行名称和要放入的类别。
- 如果你位于欧盟之外,请按照 Microsoft应用商店加入过程 并指定相应的类别,将应用程序加入到 Microsoft 应用商店。
Recommended section
这是“已固定项”部分下面的部分。 首次启动时,将在此位置预先填充 Microsoft 的“入门”应用。 OEM 还可以使用欢迎或首次运行体验应用来预先填充该部分,除非客户删除该应用,否则它会保持固定长达七天时间。
可用的自定义项:此部分包含一个项。 在 LayoutModification.json 中使用 firstRunOEMPins 进行配置。
- 为获取最佳和最整洁的用户体验,我们建议为“建议”部分选择未预先固定到任务栏或“开始”菜单固定项的第一页的应用。
自定义“开始”菜单项
Important
不支持使用 WCD 或 Unattend 自定义 Windows 11“开始”菜单,而需使用 LayoutModification.json。
OEM 可以通过创建自定义 LayoutModification.json 文件并将其添加到 %localappdata%\Microsoft\Windows\Shell 文件夹中的映像来自定义“开始”菜单布局。 映像中只需要一个 LayoutModification.json,因为这些文件可以包含一个或多个顶级成员的任意组合。
Important
确保 LayoutModification.json 使用 UTF-8 编码。
LayoutModification.json
LayoutModification.json 允许你在“开始”菜单布局的可自定义部分中配置固定项。
LayoutModification.json members
| Member | Description |
|---|---|
| primaryOEMPins | 配置在“已固定”部分的第 1 页上显示的项。 最多可以指定四个项,组合形式不限。 |
| secondaryOEMPins | 配置显示在“已固定”部分末尾的项。 最多可以指定四个项,组合形式不限。 |
| firstRunOEMPins | 在“建议”部分中配置 OEM 可配置的项。 可以指定一个项。 |
LayoutModification.json keys
上述每个成员都可以使用以下可能的成员来定义每个部分的固定项:
| Key | Description |
|---|---|
| packagedAppID |
|
| desktopAppID | 指定未打包的 Win32 应用。 若要固定 Win32 应用,请使用应用的 AUMID。 如果应用没有 AUMID,请改用 desktopAppLink 指定它。 |
| desktopAppLink | 指定未关联 AUMID 的未打包 Win32 应用。 若要固定此类应用,请使用指向该应用的 .lnk 快捷方式的路径。 |
| 字幕 | 仅适用于 firstRunOEMPins 项。 当用户将鼠标悬停在磁贴上时显示的文本字符串。对于包含多种语言的映像,你可以为不同的语言指定不同的文本(如以下示例所示),并指定在用户的语言与任何显式指定的语言不匹配时用作后备的默认描述文字。 有关如何为描述文字指定语言的详细信息,请参阅描述文字的语言标记。 |
| secondaryTile | 请参阅固定 Web 链接。 |
| tileID | 为每个辅助磁贴生成的唯一标识符。 仅用于指定辅助磁贴。 |
示例 LayoutModification.json 文件
下面的示例 LayoutModification.json 文件显示了三个可自定义“开始”菜单部分的自定义项:
-
primaryOEMPins中的三项:一个 UWP 应用、一个 Win32 应用和一个 Web 链接 -
secondaryOEMPins中的两项:一个 Web 链接和一个 Win32 应用 -
firstRunOEMPins中的一项:一个由 .lnk 文件指定的 Win32 应用
{ "primaryOEMPins": [
{ "packagedAppId": "OEM.App1_1abcde2f3ghjk!App"},
{ "desktopAppLink": "%ALLUSERSPROFILE%\\Microsoft\\Windows\\Start Menu\\Programs\\MyWin32App.lnk"},
{ "packagedAppId": "Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App",
"tileId": "MSEdge.paomdnjincdkenhiicpl.UserData.Default"}
],
"secondaryOEMPins": [
{ "packagedAppId": "Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App",
"tileId": "MSEdge.anfoedbkjbcacemdbigf.UserData.Default" },
{ "desktopAppId": "Contoso.Desktop.Example.AUMID"}
],
"firstRunOEMPins": [
{ "desktopAppLink": "%ALLUSERSPROFILE%\\Microsoft\\Windows\\Start Menu\\Programs\\PutMeInRecommended.lnk",
"caption": {
"en-US": "(localized caption text for US English)",
"de": "(localized caption text for German)",
"default": "(fallback caption text for other languages)" }
}
]
}
Tip
每个反斜杠字符 (\) 都需要按照 JSON 语法转义为 \\。
Pin Conflicts
动态交付的应用:在 Microsoft 尝试动态固定第一方或第三方应用之前,它首先检查 OEM 是否已在任何页面上固定完全相同的应用。 如果是,Microsoft 会保留该 OEM 应用的固定位置。
Microsoft 在第 1 页上静态定义的第一方应用:固定在第 1 页上的 Microsoft 第一方应用(例如:Microsoft Edge、邮件、应用商店)无法由 OEM 移动。 如果 OEM 也尝试将其中一个应用固定在第 1 页上,该操作将被忽略。
提升静态定义的 Microsoft 第一方应用:OEM 可以将 Microsoft 第一方应用(例如:计算器、相机)固定在第 1 页,并将其位置移动到第 1 页,只要 Microsoft 尚未将其静态固定在第 1 页上或未固定即可。
固定 Web 链接
若要将 Web 链接固定到“开始”菜单,需要在 secondaryTile 中指定 LayoutModification.json 元素。 执行此操作的最简单方法是使用 Edge 将网站固定到“开始”菜单,然后使用 PowerShell 导出“开始”布局。
使用 Edge 固定网站
导航到要固定的网站。 单击 Edge 工具栏(三个点菜单)> 选择“更多工具”>,然后选择“固定到开始菜单””。
导出“开始”菜单布局
请参阅导出“开始”菜单布局了解如何导出“开始”菜单布局。 导出的“开始”菜单布局将包含已配置的每个 Web 链接的 secondaryTile 元素。 然后,可以将此项添加到自定义 LayoutModification.json 文件。
示例 Web 固定项
下面是 LayoutModification.json 中的一个示例 Web 固定项:
{
"secondaryTile": {
"tileId": "MSEdge._pin_mbfkklhhpckngkihcgoamfamci",
"arguments": " --pin-url=https://free.blessedness.top/ --profile-directory=Default --launch-tile",
"displayName": "Microsoft Learn: Build skills that open doors in your career",
"packagedAppId": "Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App",
"smallIconPath": "ms-appdata:///local/Pins/MSEdge._pin_mbfkklhhpckngkihcgoamfamci/SmallLogo.png",
"smallIcon": "<base64 encoded image goes here>",
"largeIconPath": "ms-appdata:///local/Pins/MSEdge._pin_mbfkklhhpckngkihcgoamfamci/Logo.png",
"largeIcon": "<base64 encoded image goes here>"
}
}
Note
从 Export-StartLayout 中导出的辅助磁贴将包含大图标和小图标的 base64 编码图像。 可以按原样使用此 JSON 代码片段,无需进行任何修改即可进行 OEM 配置。
通过在要添加固定项的部分中添加新的 JSON 对象,将此磁贴添加到 LayoutModification.json。 下面是使用上述示例将 Web 链接固定到“已固定项”部分底部后的外观:
...
"primaryOEMPins": [
{
"packagedAppId": "Contoso_8wekyb3d8bbwe!App"
},
{
"secondaryTile": {
"tileId": "MSEdge._pin_mbfkklhhpckngkihcgoamfamci",
"arguments": " --pin-url=https://free.blessedness.top/ --profile-directory=Default --launch-tile",
"displayName": "Microsoft Learn: Build skills that open doors in your career",
"packagedAppId": "Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App",
"smallIconPath": "ms-appdata:///local/Pins/MSEdge._pin_mbfkklhhpckngkihcgoamfamci/SmallLogo.png",
"smallIcon": "<base64 encoded image goes here>",
"largeIconPath": "ms-appdata:///local/Pins/MSEdge._pin_mbfkklhhpckngkihcgoamfamci/Logo.png",
"largeIcon": "<base64 encoded image goes here>"
}
}
]
...
Pre-pinning Office
如果预装了 Office 即点即用 (C2R) 应用,Windows 会将这些应用自动固定到“开始”菜单。 使用 Office 预安装工具包 (OPK) 安装 C2R 版本的 Office,Windows 将自动检测 Office 安装并将相应的固定项添加到“开始”菜单。 并非每个 C2R Office 应用(只有 Word、Excel 和 PowerPoint)都会固定到“开始”菜单。 此行为是完全自动的,不需要 LayoutModification.json 中的任何内容。
如果未预装 C2R Office,固定到“开始”菜单的其他项将滑动以填充这些应用的位置,这样就不会在布局中间留下空隙。
将布局添加到映像
装载 Windows 映像。
dism /mount-image /imagefile:E:\Sources\install.wim /mountdir:C:\mount /index:1将
LayoutModification.json复制到已装载的映像。 Windows 将在\Windows\Users\Default\Appdata\Local\Microsoft\Windows\Shell文件夹中查找此文件。 如果文件夹中已存在布局修改文件,请将现有文件替换为新文件。xcopy /s LayoutModification.json C:\Mount\Users\Default\Appdata\Local\Microsoft\Windows\Shell卸载映像并提交更改。
dism /unmount-image /mountdir:C:\mount /commit
描述文字的语言标记
下表包含用于 Windows 11 支持的每种语言的标记:
- 如果知道语言/区域设置,请在第一列中搜索它,并使用第二列中的相应标记(注意:标记被视为区分大小写,因此请确保使用例如 en-US 而不是 en-us)。
- 不要使用第三列中的标记。 但是,如果你认为自己使用的标记不正确,并且想要查找相应的正确标记,你可以尝试在第三列中搜索你尝试使用的标记,然后从第二列中查看正确的标记应该是什么。
| Windows Language | 要在 LayoutModification.json 中使用的标记 | 旧式标记(如果与第二列不同,请勿使用) |
|---|---|---|
| Afrikaans | af | af-ZA |
| Albanian | sq | sq-AL |
| Alsatian | gsw | gsw-CH |
| Amharic | am | am-ET |
| Arabic (Algeria) | ar-DZ | ar-DZ |
| Arabic (Bahrain) | ar-BH | ar-BH |
| Arabic (Egypt) | ar-EG | ar-EG |
| Arabic (Iraq) | ar-IQ | ar-IQ |
| Arabic (Jordan) | ar-JO | ar-JO |
| Arabic (Kuwait) | ar-KW | ar-KW |
| Arabic (Lebanon) | ar-LB | ar-LB |
| Arabic (Libya) | ar-LY | ar-LY |
| Arabic (Morocco) | ar-MA | ar-MA |
| Arabic (Oman) | ar-OM | ar-OM |
| Arabic (Qatar) | ar-QA | ar-QA |
| 阿拉伯语(沙特阿拉伯) | ar-SA | ar-SA |
| Arabic (Syria) | ar-SY | ar-SY |
| Arabic (Tunisia) | ar-TN | ar-TN |
| 阿拉伯语(阿拉伯联合酋长国) | ar-AE | ar-AE |
| Arabic (Yemen) | ar-YE | ar-YE |
| Armenian | hy | hy-AM |
| Assamese | as | as-IN |
| Azerbaijani (Cyrillic) | az-Cyrl | az-Cyrl-AZ |
| Azerbaijani (Latin) | az-Latn | az-Latn-AZ |
| Bangla (Bangladesh) | bn-BD | bn-BD |
| Bashkir | ba-Cyrl | ba-RU |
| Basque | eu | eu-ES |
| Belarusian | be | be-BY |
| Bengali (India) | bn-IN | bn-IN |
| Bosnian (Cyrillic) | bs-Cyrl | bs-Cyrl-BA |
| Bosnian (Latin) | bs | bs-Latn-BA |
| Breton | br-Latn | br-FR |
| Bulgarian | bg | bg-BG |
| Burmese | my | my-MM |
| Catalan | ca | ca-ES |
| 宿务语(拉丁语,菲律宾) | ceb-Latn-PH | ceb-Latn-PH |
| Central Kurdish | ku-Arab | ku-Arab-IQ |
| 查克马语(查克马语,孟加拉国) | ccp-Cakm-BD | ccp-Cakm-BD |
| 查克马语(查克马语,印度) | ccp-Cakm-IN | ccp-Cakm-IN |
| Cherokee (Cherokee) | chr-Cher | chr-Cher-US |
| 中文(简体,中国) | zh-Hans-CN | zh-CN |
| 中文(简体,新加坡) | zh-Hans-SG | zh-SG |
| 中文(繁体,香港特别行政区) | zh-Hant-HK | zh-HK |
| 中文(繁体,澳门特别行政区) | zh-Hant-MO | zh-MO |
| 中文(繁体,台湾) | zh-Hant-TW | zh-TW |
| Corsican | co-Latn | co-FR |
| 克罗地亚语(波斯尼亚和黑塞哥维那) | hr-BA | hr-BA |
| Croatian (Croatia) | hr-HR | hr-HR |
| Czech | cs | cs-CZ |
| Danish | da | da-DK |
| Dari | prs-Arab | prs-AF |
| Divehi | dv | dv-MV |
| Dutch (Belgium) | nl-BE | nl-BE |
| Dutch (Netherlands) | nl-NL | nl-NL |
| Dzongkha | dz | dz-BT |
| English (Australia) | en-AU | en-AU |
| English (Belize) | en-BZ | en-BZ |
| English (Canada) | en-CA | en-CA |
| English (Caribbean) | en-029 | en-029 |
| English (India) | en-IN | en-IN |
| English (Ireland) | en-IE | en-IE |
| English (Jamaica) | en-JM | en-JM |
| English (Malaysia) | en-MY | en-MY |
| 英语(新西兰) | en-NZ | en-NZ |
| English (Philippines) | en-PH | en-PH |
| English (Singapore) | en-SG | en-SG |
| 英语(南非) | en-ZA | en-ZA |
| 英语(特立尼达和多巴哥) | en-TT | en-TT |
| 英语(阿拉伯联合酋长国) | en-AE | en-AE |
| 英语(英国) | en-GB | en-GB |
| 英语(美国) | en-US | en-US |
| English (Zimbabwe) | en-ZW | en-ZW |
| Estonian | et | et-EE |
| Faroese | fo | fo-FO |
| Filipino | fil-Latn | fil-PH |
| Finnish | fi | fi-FI |
| French (Belgium) | fr-BE | fr-BE |
| French (Canada) | fr-CA | fr-CA |
| French (Caribbean) | fr-029 | fr-029 |
| French (France) | fr-FR | fr-FR |
| French (Luxembourg) | fr-LU | fr-LU |
| French (Monaco) | fr-MC | fr-MC |
| French (Switzerland) | fr-CH | fr-CH |
| Frisian | fy | fy-NL |
| 富拉语(阿德拉姆文,布基纳法索) | ff-Adlm-BF | ff-Adlm-BF |
| 富拉语(阿德拉姆文,喀麦隆) | ff-Adlm-CM | ff-Adlm-CM |
| 富拉语(阿德拉姆文,冈比亚) | ff-Adlm-GM | ff-Adlm-GM |
| 富拉语(阿德拉姆文,加纳) | ff-Adlm-GH | ff-Adlm-GH |
| 富拉语(阿德拉姆文,几内亚) | ff-Adlm-GN | ff-Adlm-GN |
| 富拉语(阿德拉姆文,几内亚比绍) | ff-Adlm-GW | ff-Adlm-GW |
| 富拉语(阿德拉姆文,利比里亚) | ff-Adlm-LR | ff-Adlm-LR |
| 富拉语(阿德拉姆文,毛里塔尼亚) | ff-Adlm-MR | ff-Adlm-MR |
| 富拉语(阿德拉姆文,尼日尔) | ff-Adlm-NE | ff-Adlm-NE |
| 富拉语(阿德拉姆文,尼日利亚) | ff-Adlm-NG | ff-Adlm-NG |
| 富拉语(阿德拉姆文,塞内加尔) | ff-Adlm-SN | ff-Adlm-SN |
| 富拉语(阿德拉姆文,塞拉利昂) | ff-Adlm-SL | ff-Adlm-SL |
| 富拉语(拉丁语,布基纳法索) | ff-Latn-BF | ff-Latn-BF |
| 富拉语(拉丁语,喀麦隆) | ff-Latn-CM | ff-Latn-CM |
| 富拉语(拉丁语,冈比亚) | ff-Latn-GM | ff-Latn-GM |
| 富拉语(拉丁语,加纳) | ff-Latn-GH | ff-Latn-GH |
| 富拉语(拉丁语,几内亚) | ff-Latn-GN | ff-Latn-GN |
| 富拉语(拉丁语,几内亚比绍) | ff-Latn-GW | ff-Latn-GW |
| 富拉语(拉丁语,利比里亚) | ff-Latn-LR | ff-Latn-LR |
| 富拉语(拉丁语,毛里塔尼亚) | ff-Latn-MR | ff-Latn-MR |
| 富拉语(拉丁语,尼日尔) | ff-Latn-NE | ff-Latn-NE |
| 富拉语(拉丁语,尼日利亚) | ff-Latn-NG | ff-Latn-NG |
| 富拉语(拉丁语,塞内加尔) | ff-Latn-SN | ff-Latn-SN |
| 富拉语(拉丁语,塞拉利昂) | ff-Latn-SL | ff-Latn-SL |
| Galician | gl | gl-ES |
| Georgian | ka | ka-GE |
| German (Austria) | de-AT | de-AT |
| German (Germany) | de-DE | de-DE |
| German (Liechtenstein) | de-LI | de-LI |
| German (Luxembourg) | de-LU | de-LU |
| German (Switzerland) | de-CH | de-CH |
| Greek | el | el-GR |
| Gujarati | gu | gu-IN |
| Hausa (Latin) | ha-Latn | ha-Latn-NG |
| Hawaiian | haw-Latn | haw-US |
| Hebrew | he | he-IL |
| Hindi | hi | hi-IN |
| Hungarian | hu | hu-HU |
| Icelandic | is | is-IS |
| Igbo | ig-Latn | ig-NG |
| Inari Sami | smn-Latn | smn-FI |
| Indonesian | id | id-ID |
| 因纽特语(加拿大土著音节文字) | iu-Cans | iu-Cans-CA |
| Inuktitut (Latin) | iu-Latn | iu-Latn-CA |
| Irish | ga | ga-IE |
| 爱尔兰语(英国) | ga-GB | ga-GB |
| isiXhosa | xh | xh-ZA |
| isiZulu | zu | zu-ZA |
| Italian (Italy) | it-IT | it-IT |
| Italian (Switzerland) | it-CH | it-CH |
| Japanese | ja | ja-JP |
| K’iche’ | quc-Latn | quc-Latn-GT |
| Kalaallisut | kl | kl-GL |
| Kannada | kn | kn-IN |
| Kazakh | kk | kk-KZ |
| Khmer | km | km-KH |
| Kinyarwanda | rw | rw-RW |
| Kiswahili | sw | sw-KE |
| Konkani | kok | kok-IN |
| Korean | ko | ko-KR |
| Kyrgyz | ky-Cyrl | ky-KG |
| Lao | lo | lo-LA |
| Latvian | lv | lv-LV |
| Lithuanian | lt | lt-LT |
| Lower Sorbian | dsb | dsb-DE |
| 律勒萨米语(挪威) | smj-Latn-NO | smj-NO |
| 律勒萨米语(瑞典) | smj-Latn-SE | smj-SE |
| Luxembourgish | lb | lb-LU |
| Macedonian | mk | mk-MK |
| Malay (Brunei) | ms-BN | ms-BN |
| Malay (Malaysia) | ms-MY | ms-MY |
| Malayalam | ml | ml-IN |
| Maltese | mt | mt-MT |
| Maori | mi-Latn | mi-NZ |
| Mapuche | arn-Latn | arn-CL |
| Marathi | mr | mr-IN |
| Mohawk | moh-Latn | moh-CA |
| Mongolian (Cyrillic) | mn-Cyrl | mn-MN |
| 蒙古语(传统蒙古语) | mn-Mong | mn-Mong-CN |
| Nepali (India) | ne-IN | ne-IN |
| Nepali (Nepal) | ne-NP | ne-NP |
| 北萨米语(芬兰) | se-Latn-FI | se-FI |
| 北萨米语(挪威) | se-Latn-NO | se-NO |
| 北萨米语(瑞典) | se-Latn-SE | se-SE |
| Norwegian (Bokmål) | nb | nb-NO |
| Norwegian (Nynorsk) | nn | nn-NO |
| Occitan | oc-Latn | oc-FR |
| Odia | or | or-IN |
| Pashto | ps | ps-AF |
| Pashto (Pakistan) | ps-PK | ps-PK |
| Persian | fa | fa-IR |
| Polish | pl | pl-PL |
| Portuguese (Brazil) | pt-BR | pt-BR |
| Portuguese (Portugal) | pt-PT | pt-PT |
| Punjabi (Arabic) | pa-Arab | pa-Arab-PK |
| Punjabi (Gurmukhi) | pa | pa-IN |
| Quechua (Bolivia) | quz-Latn-BO | quz-BO |
| Quechua (Ecuador) | quz-Latn-EC | quz-EC |
| Quechua (Peru) | quz-Latn-PE | quz-PE |
| Romanian (Moldova) | ro-MD | ro-MD |
| Romanian (Romania) | ro-RO | ro-RO |
| Romansh | rm | rm-CH |
| Russian | ru | ru-RU |
| Sakha | sah-Cyrl | sah-RU |
| Sanskrit | sa-Deva | sa-IN |
| Scottish Gaelic | gd-Latn | gd-GB |
| 塞尔维亚语(西里尔文,波斯尼亚和黑塞哥维那) | sr-Cyrl-BA | sr-Cyrl-BA |
| 塞尔维亚语(西里尔文,黑山) | sr-Cyrl-ME | sr-Cyrl-ME |
| 塞尔维亚语(西里尔文,塞尔维亚) | sr-Cyrl-RS | sr-Cyrl-RS |
| 塞尔维亚语(拉丁语,波斯尼亚和黑塞哥维那) | sr-Latn-BA | sr-Latn-BA |
| 塞尔维亚语(拉丁语,黑山) | sr-Latn-ME | sr-Latn-ME |
| 塞尔维亚语(拉丁语,塞尔维亚) | sr-Latn-RS | sr-Latn-RS |
| 北索托语 | nso | nso-ZA |
| Setswana (Botswana) | tn-BW | tn-BW |
| 茨瓦纳语(南非) | tn-ZA | tn-ZA |
| Sindhi (Arabic) | sd-Arab | sd-Arab-PK |
| Sinhala | si | si-LK |
| Skolt Sami | sms-Latn | sms-FI |
| Slovak | sk | sk-SK |
| Slovenian | sl | sl-SI |
| 南萨米语(挪威) | sma-Latn-NO | sma-NO |
| 南萨米语(瑞典) | sma-Latn-SE | sma-SE |
| Spanish (Argentina) | es-AR | es-AR |
| Spanish (Bolivia) | es-BO | es-BO |
| Spanish (Chile) | es-CL | es-CL |
| Spanish (Colombia) | es-CO | es-CO |
| 西班牙语(哥斯达黎加) | es-CR | es-CR |
| 西班牙语(多米尼加共和国) | es-DO | es-DO |
| Spanish (Ecuador) | es-EC | es-EC |
| 西班牙语(萨尔瓦多) | es-SV | es-SV |
| Spanish (Guatemala) | es-GT | es-GT |
| Spanish (Honduras) | es-HN | es-HN |
| 西班牙语(拉丁美洲) | es-419 | es-419 |
| Spanish (Mexico) | es-MX | es-MX |
| Spanish (Nicaragua) | es-NI | es-NI |
| Spanish (Panama) | es-PA | es-PA |
| Spanish (Paraguay) | es-PY | es-PY |
| Spanish (Peru) | es-PE | es-PE |
| 西班牙语(波多黎各) | es-PR | es-PR |
| Spanish (Spain) | es-ES | es-ES |
| 西班牙语(美国) | es-US | es-US |
| Spanish (Uruguay) | es-UY | es-UY |
| Spanish (Venezuela) | es-VE | es-VE |
| 标准摩洛哥塔马赛特语 | zgh-Tfng | zgh-Tfng-MA |
| Swedish (Finland) | sv-FI | sv-FI |
| Swedish (Sweden) | sv-SE | sv-SE |
| Syriac | syr-Syrc | syr-SY |
| Tajik (Cyrillic) | tg-Cyrl | tg-Cyrl-TJ |
| Tamil (India) | ta-IN | ta-IN |
| Tamil (Malaysia) | ta-MY | ta-MY |
| Tamil (Singapore) | ta-SG | ta-SG |
| 泰米尔语(斯里兰卡) | ta-LK | ta-LK |
| Tatar (Cyrillic) | tt-Cyrl | tt-RU |
| Telugu | te | te-IN |
| Thai | th | th-TH |
| Tibetan | bo-Tibt | bo-CN |
| Tigrinya (Eritrea) | ti-ER | ti-ER |
| Tigrinya (Ethiopia) | ti-ET | ti-ET |
| Turkish | tr | tr-TR |
| Turkmen (Latin) | tk-Latn | tk-TM |
| Ukrainian | uk | uk-UA |
| Upper Sorbian | hsb | hsb-DE |
| Urdu (India) | ur-IN | ur-IN |
| Urdu (Pakistan) | ur-PK | ur-PK |
| Uyghur | ug-Arab | ug-CN |
| Uzbek (Cyrillic) | uz-Cyrl | uz-Cyrl-UZ |
| Uzbek (Latin) | uz-Latn | uz-Latn-UZ |
| Valencian | ca-ES-valencia | ca-ES-valencia |
| Vietnamese | vi | vi-VN |
| Welsh | cy | cy-GB |
| Wolof | wo-Latn | wo-SN |
| Yi | ii-Yiii | ii-CN |
| Yoruba | yo-Latn | yo-NG |
JSON example
下面的示例 JSON 代码片段展示了如何使用每个可用语言标记的示例
对于已为其提供本地化文本的语言/区域设置,请将代码片段中的占位符语言名称替换为实际文本。
对于不打算为其提供本地化文本的语言/区域设置,请删除代码片段中的相应行。 系统将回退到底部的
default条目,以便为这些语言/区域设置显示该文本。对于具有多个区域设置变体的任何语言,可以仅指定主要标记(第一个连字符之前的部分)作为该语言所有其他区域设置的后备标记。 For example:
"caption": { "en-US": "English (United States)", "en-GB": "English (United Kingdom)", "en": "text for all other locale variants of English"}这将提供专门针对美国英语和英国英语的文本,然后对于英语的所有其他语言环境变体(例如,en-CA 表示加拿大英语),系统将使用“en”标题文本。
可用描述文字语言的完整列表:
"caption": {
"af": "Afrikaans",
"sq": "Albanian",
"gsw": "Alsatian",
"am": "Amharic",
"ar-DZ": "Arabic (Algeria)",
"ar-BH": "Arabic (Bahrain)",
"ar-EG": "Arabic (Egypt)",
"ar-IQ": "Arabic (Iraq)",
"ar-JO": "Arabic (Jordan)",
"ar-KW": "Arabic (Kuwait)",
"ar-LB": "Arabic (Lebanon)",
"ar-LY": "Arabic (Libya)",
"ar-MA": "Arabic (Morocco)",
"ar-OM": "Arabic (Oman)",
"ar-QA": "Arabic (Qatar)",
"ar-SA": "Arabic (Saudi Arabia)",
"ar-SY": "Arabic (Syria)",
"ar-TN": "Arabic (Tunisia)",
"ar-AE": "Arabic (United Arab Emirates)",
"ar-YE": "Arabic (Yemen)",
"hy": "Armenian",
"as": "Assamese",
"az-Cyrl": "Azerbaijani (Cyrillic)",
"az-Latn": "Azerbaijani (Latin)",
"bn-BD": "Bangla (Bangladesh)",
"ba-Cyrl": "Bashkir",
"eu": "Basque",
"be": "Belarusian",
"bn-IN": "Bengali (India)",
"bs-Cyrl": "Bosnian (Cyrillic)",
"bs": "Bosnian (Latin)",
"br-Latn": "Breton",
"bg": "Bulgarian",
"my": "Burmese",
"ca": "Catalan",
"ceb-Latn-PH": "Cebuano (Latin, Philippines)",
"ku-Arab": "Central Kurdish",
"ccp-Cakm-BD": "Chakma (Chakma, Bangladesh)",
"ccp-Cakm-IN": "Chakma (Chakma, India)",
"chr-Cher": "Cherokee (Cherokee)",
"zh-Hans-CN": "Chinese (Simplified, China)",
"zh-Hans-SG": "Chinese (Simplified, Singapore)",
"zh-Hant-HK": "Chinese (Traditional, Hong Kong SAR)",
"zh-Hant-MO": "Chinese (Traditional, Macao SAR)",
"zh-Hant-TW": "Chinese (Traditional, Taiwan)",
"co-Latn": "Corsican",
"hr-BA": "Croatian (Bosnia and Herzegovina)",
"hr-HR": "Croatian (Croatia)",
"cs": "Czech",
"da": "Danish",
"prs-Arab": "Dari",
"dv": "Divehi",
"nl-BE": "Dutch (Belgium)",
"nl-NL": "Dutch (Netherlands)",
"dz": "Dzongkha",
"en-AU": "English (Australia)",
"en-BZ": "English (Belize)",
"en-CA": "English (Canada)",
"en-029": "English (Caribbean)",
"en-IN": "English (India)",
"en-IE": "English (Ireland)",
"en-JM": "English (Jamaica)",
"en-MY": "English (Malaysia)",
"en-NZ": "English (New Zealand)",
"en-PH": "English (Philippines)",
"en-SG": "English (Singapore)",
"en-ZA": "English (South Africa)",
"en-TT": "English (Trinidad and Tobago)",
"en-AE": "English (United Arab Emirates)",
"en-GB": "English (United Kingdom)",
"en-US": "English (United States)",
"en-ZW": "English (Zimbabwe)",
"et": "Estonian",
"fo": "Faroese",
"fil-Latn": "Filipino",
"fi": "Finnish",
"fr-BE": "French (Belgium)",
"fr-CA": "French (Canada)",
"fr-029": "French (Caribbean)",
"fr-FR": "French (France)",
"fr-LU": "French (Luxembourg)",
"fr-MC": "French (Monaco)",
"fr-CH": "French (Switzerland)",
"fy": "Frisian",
"ff-Adlm-BF": "Fulah (Adlam, Burkina Faso)",
"ff-Adlm-CM": "Fulah (Adlam, Cameroon)",
"ff-Adlm-GM": "Fulah (Adlam, Gambia)",
"ff-Adlm-GH": "Fulah (Adlam, Ghana)",
"ff-Adlm-GN": "Fulah (Adlam, Guinea)",
"ff-Adlm-GW": "Fulah (Adlam, Guinea-Bissau)",
"ff-Adlm-LR": "Fulah (Adlam, Liberia)",
"ff-Adlm-MR": "Fulah (Adlam, Mauritania)",
"ff-Adlm-NE": "Fulah (Adlam, Niger)",
"ff-Adlm-NG": "Fulah (Adlam, Nigeria)",
"ff-Adlm-SN": "Fulah (Adlam, Senegal)",
"ff-Adlm-SL": "Fulah (Adlam, Sierra Leone)",
"ff-Latn-BF": "Fulah (Latin, Burkina Faso)",
"ff-Latn-CM": "Fulah (Latin, Cameroon)",
"ff-Latn-GM": "Fulah (Latin, Gambia)",
"ff-Latn-GH": "Fulah (Latin, Ghana)",
"ff-Latn-GN": "Fulah (Latin, Guinea)",
"ff-Latn-GW": "Fulah (Latin, Guinea-Bissau)",
"ff-Latn-LR": "Fulah (Latin, Liberia)",
"ff-Latn-MR": "Fulah (Latin, Mauritania)",
"ff-Latn-NE": "Fulah (Latin, Niger)",
"ff-Latn-NG": "Fulah (Latin, Nigeria)",
"ff-Latn-SN": "Fulah (Latin, Senegal)",
"ff-Latn-SL": "Fulah (Latin, Sierra Leone)",
"gl": "Galician",
"ka": "Georgian",
"de-AT": "German (Austria)",
"de-DE": "German (Germany)",
"de-LI": "German (Liechtenstein)",
"de-LU": "German (Luxembourg)",
"de-CH": "German (Switzerland)",
"el": "Greek",
"gu": "Gujarati",
"ha-Latn": "Hausa (Latin)",
"haw-Latn": "Hawaiian",
"he": "Hebrew",
"hi": "Hindi",
"hu": "Hungarian",
"is": "Icelandic",
"ig-Latn": "Igbo",
"smn-Latn": "Inari Sami",
"id": "Indonesian",
"iu-Cans": "Inuktitut (Canadian Aboriginal Syllabics)",
"iu-Latn": "Inuktitut (Latin)",
"ga": "Irish",
"ga-GB": "Irish (United Kingdom)",
"xh": "isiXhosa",
"zu": "isiZulu",
"it-IT": "Italian (Italy)",
"it-CH": "Italian (Switzerland)",
"ja": "Japanese",
"quc-Latn": "K’iche’",
"kl": "Kalaallisut",
"kn": "Kannada",
"kk": "Kazakh",
"km": "Khmer",
"rw": "Kinyarwanda",
"sw": "Kiswahili",
"kok": "Konkani",
"ko": "Korean",
"ky-Cyrl": "Kyrgyz",
"lo": "Lao",
"lv": "Latvian",
"lt": "Lithuanian",
"dsb": "Lower Sorbian",
"smj-Latn-NO": "Lule Sami (Norway)",
"smj-Latn-SE": "Lule Sami (Sweden)",
"lb": "Luxembourgish",
"mk": "Macedonian",
"ms-BN": "Malay (Brunei)",
"ms-MY": "Malay (Malaysia)",
"ml": "Malayalam",
"mt": "Maltese",
"mi-Latn": "Maori",
"arn-Latn": "Mapuche",
"mr": "Marathi",
"moh-Latn": "Mohawk",
"mn-Cyrl": "Mongolian (Cyrillic)",
"mn-Mong": "Mongolian (Traditional Mongolian)",
"ne-IN": "Nepali (India)",
"ne-NP": "Nepali (Nepal)",
"se-Latn-FI": "Northern Sami (Finland)",
"se-Latn-NO": "Northern Sami (Norway)",
"se-Latn-SE": "Northern Sami (Sweden)",
"nb": "Norwegian (Bokmål)",
"nn": "Norwegian (Nynorsk)",
"oc-Latn": "Occitan",
"or": "Odia",
"ps": "Pashto",
"ps-PK": "Pashto (Pakistan)",
"fa": "Persian",
"pl": "Polish",
"pt-BR": "Portuguese (Brazil)",
"pt-PT": "Portuguese (Portugal)",
"pa-Arab": "Punjabi (Arabic)",
"pa": "Punjabi (Gurmukhi)",
"quz-Latn-BO": "Quechua (Bolivia)",
"quz-Latn-EC": "Quechua (Ecuador)",
"quz-Latn-PE": "Quechua (Peru)",
"ro-MD": "Romanian (Moldova)",
"ro-RO": "Romanian (Romania)",
"rm": "Romansh",
"ru": "Russian",
"sah-Cyrl": "Sakha",
"sa-Deva": "Sanskrit",
"gd-Latn": "Scottish Gaelic",
"sr-Cyrl-BA": "Serbian (Cyrillic, Bosnia and Herzegovina)",
"sr-Cyrl-ME": "Serbian (Cyrillic, Montenegro)",
"sr-Cyrl-RS": "Serbian (Cyrillic, Serbia)",
"sr-Latn-BA": "Serbian (Latin, Bosnia and Herzegovina)",
"sr-Latn-ME": "Serbian (Latin, Montenegro)",
"sr-Latn-RS": "Serbian (Latin, Serbia)",
"nso": "Sesotho sa Leboa",
"tn-BW": "Setswana (Botswana)",
"tn-ZA": "Setswana (South Africa)",
"sd-Arab": "Sindhi (Arabic)",
"si": "Sinhala",
"sms-Latn": "Skolt Sami",
"sk": "Slovak",
"sl": "Slovenian",
"sma-Latn-NO": "Southern Sami (Norway)",
"sma-Latn-SE": "Southern Sami (Sweden)",
"es-AR": "Spanish (Argentina)",
"es-BO": "Spanish (Bolivia)",
"es-CL": "Spanish (Chile)",
"es-CO": "Spanish (Colombia)",
"es-CR": "Spanish (Costa Rica)",
"es-DO": "Spanish (Dominican Republic)",
"es-EC": "Spanish (Ecuador)",
"es-SV": "Spanish (El Salvador)",
"es-GT": "Spanish (Guatemala)",
"es-HN": "Spanish (Honduras)",
"es-419": "Spanish (Latin America)",
"es-MX": "Spanish (Mexico)",
"es-NI": "Spanish (Nicaragua)",
"es-PA": "Spanish (Panama)",
"es-PY": "Spanish (Paraguay)",
"es-PE": "Spanish (Peru)",
"es-PR": "Spanish (Puerto Rico)",
"es-ES": "Spanish (Spain)",
"es-US": "Spanish (United States)",
"es-UY": "Spanish (Uruguay)",
"es-VE": "Spanish (Venezuela)",
"zgh-Tfng": "Standard Moroccan Tamazight",
"sv-FI": "Swedish (Finland)",
"sv-SE": "Swedish (Sweden)",
"syr-Syrc": "Syriac",
"tg-Cyrl": "Tajik (Cyrillic)",
"ta-IN": "Tamil (India)",
"ta-MY": "Tamil (Malaysia)",
"ta-SG": "Tamil (Singapore)",
"ta-LK": "Tamil (Sri Lanka)",
"tt-Cyrl": "Tatar (Cyrillic)",
"te": "Telugu",
"th": "Thai",
"bo-Tibt": "Tibetan",
"ti-ER": "Tigrinya (Eritrea)",
"ti-ET": "Tigrinya (Ethiopia)",
"tr": "Turkish",
"tk-Latn": "Turkmen (Latin)",
"uk": "Ukrainian",
"hsb": "Upper Sorbian",
"ur-IN": "Urdu (India)",
"ur-PK": "Urdu (Pakistan)",
"ug-Arab": "Uyghur",
"uz-Cyrl": "Uzbek (Cyrillic)",
"uz-Latn": "Uzbek (Latin)",
"ca-ES-valencia": "Valencian",
"vi": "Vietnamese",
"cy": "Welsh",
"wo-Latn": "Wolof",
"ii-Yiii": "Yi",
"yo-Latn": "Yoruba",
"default": "fallback caption for other languages"
}