自定义 Windows 11 开始布局

正在查找本主题的 IT 专业人员版本? 请参阅自定义Windows 11上的"开始"菜单布局

提示

若要获取本主题的 Windows 10 版本,请参阅自定义 Windows 10“开始”菜单布局

OEM 可以自定义 Windows 11“开始”菜单布局,以便将 OEM 定义的项(应用和/或网站)固定在“开始”菜单中的特定区域。

“开始”菜单布局自定义项是使用 LayoutModification.json 和可选的 LayoutModification.xml 配置的:

  • LayoutModification.json 提供对应用固定功能的全面支持
  • LayoutModification.xml 用于将网站固定功能添加到 LayoutModification.json

注意

不能使用 Windows 配置设计器或 Unattend 文件来配置 Windows 11“开始”菜单。

“开始”菜单部分

“开始”菜单由三个部分组成:“已固定项”、“所有应用”和“建议”。 LayoutModification.json 可以包含“已固定项”和/或“建议”部分的自定义项。

“已固定项”部分

“开始”菜单顶部的部分名为“已固定项”部分。 此部分由网格中排列的固定应用组成。 此部分中的项是电脑上安装的所有应用中的一部分;此部分默认不会包含所有已安装的应用。 无论设备面板大小如何,此视图中的行数和项数都保持一致。

虽然此部分的初始视图显示 18 个项,但用户可以使用分页控件来浏览其他固定应用的页面。 此部分中的项是 Microsoft 定义的应用、动态交付的应用和 OEM 配置项的组合。 设置电脑后,用户可以在此部分中添加、移动或删除固定应用。

可用的自定义项:

  • 此部分的第 1 页最多包含四个项。 在 LayoutModification.json 中使用 primaryOEMPins 进行配置。
  • 已固定应用网格底部最多包含四个项。 用户需要在“开始”菜单中向下滚动才能看到这些固定应用。 在 LayoutModification.json 中使用 secondaryOEMPins 进行配置。

如果在其中任一部分中固定四个以下的项,则 Microsoft 定义的其他应用将会滑动,以填充空白空间来保持相同的顺序。 将忽略前四个数组元素以外的任何数组元素。

注意

一个项只能在“已固定项”部分中显示一次。 在此部分,无法将应用固定在多个位置,不管是固定在相同还是不同的页面上。

“所有应用”部分

当用户单击“开始”菜单右上角的“所有应用”时,就会显示此部分。 “所有应用”是按字母顺序列出的所有已安装应用的综合列表。

可用的自定义项

  • 此部分没有自定义项。 “所有应用”是一个包含所有已安装应用的列表,不能由用户或 OEM 自定义。

这是“已固定项”部分下面的部分。 首次启动时,将在此位置预先填充 Microsoft 的“入门”应用。 OEM 还可以使用欢迎或首次运行体验应用来预先填充该部分,除非客户删除该应用,否则它会保持固定长达七天时间。

可用的自定义项:此部分包含一个项。 在 LayoutModification.json 中使用 firstRunOEMPins 进行配置。

  • 为获取最佳和最整洁的用户体验,建议为“建议”部分选择未预先固定到任务栏或“开始”菜单固定项的第一页的应用。

自定义“开始”菜单项

重要

不支持使用 WCD 或 Unattend 自定义 Windows 11“开始”菜单,而需使用 LayoutModification.json。

OEM 可以通过创建自定义 LayoutModification.json 文件并将其添加到 %localappdata%\Microsoft\Windows\Shell 文件夹中的映像来自定义“开始”菜单布局。 映像中只需要一个 LayoutModification.json,因为这些文件可以包含一个或多个顶级成员的任意组合。

如果要固定 Web 链接,还需要创建 LayoutModification.xml 文件以与 LayoutModification.json 结合使用。

重要

确保 LayoutModification.json 使用 UTF-8 编码。

LayoutModification.json

LayoutModification.json 允许你在“开始”菜单布局的可自定义部分中配置固定项。

LayoutModification.json 成员

成员 说明
primaryOEMPins 配置在“已固定”部分的第 1 页上显示的项。 最多可以指定四个项,组合形式不限。
secondaryOEMPins 配置显示在“已固定”部分末尾的项。 最多可以指定四个项,组合形式不限。
firstRunOEMPins 在“建议”部分中配置 OEM 可配置的项。 可以指定一个项。

LayoutModification.json 键

上述每个成员都可以使用以下可能的成员来定义每个部分的固定项:

密钥 说明
packagedAppID
  • 指定通用 Windows 平台应用。 若要固定 UWP 应用,请使用应用的 AUMID。
  • tileID 子元素结合使用可指定 Web 链接。 请参阅固定 Web 链接,了解如何固定 Web 链接。
tileID 仅与 packagedAppID 一起使用。 固定 Web 链接时对应于 LayoutModification.xml 中的 TileID
desktopAppID 指定未打包的 Win32 应用。 若要固定 Win32 应用,请使用应用的 AUMID。 如果应用没有 AUMID,请改用 desktopAppLink 指定它。
desktopAppLink 指定未关联 AUMID 的未打包 Win32 应用。 若要固定此类应用,请使用指向该应用的 .lnk 快捷方式的路径。
caption 仅适用于 firstRunOEMPins 项。 当用户将鼠标悬停在磁贴上时显示的文本字符串。

对于包含多种语言的映像,你可以为不同的语言指定不同的文本(如以下示例所示),并指定在用户的语言与任何显式指定的语言不匹配时用作后备的默认描述文字。 有关如何为描述文字指定语言的详细信息,请参阅描述文字的语言标记

示例 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)" } 
    } 
  ] 
} 

提示

每个反斜杠字符 (\) 都需要按照 JSON 语法转义为 \\

固定冲突

  • 动态交付的应用:在 Microsoft 尝试动态固定第一方或第三方应用之前,它会首先检查 OEM 是否已在任何页面上固定完全相同的应用。 如果是,Microsoft 会保留该 OEM 应用的固定位置。

  • 第 1 页上由 Microsoft 静态定义的第一方应用:Microsoft 第一方应用 (例如:Microsoft Edge、邮件、第 1 页上固定Microsoft Store) 无法由 OEM 移动。 如果 OEM 也尝试将其中一个应用固定在第 1 页上,该操作将被忽略。

  • 提升静态定义的 Microsoft 第一方应用:OEM 可能会将 Microsoft 第一方应用固定 (例如计算器、相机) 第 1 页,并将其位置移动到第 1 页,前提是 Microsoft 尚未在第 1 页中静态固定,或者未固定。

若要将 Web 链接固定到“开始”菜单,需要同时使用 LayoutModification.jsonLayoutModification.xml 文件。

Web 链接使用 LayoutModification.xml 和 LayoutModification.json 这两个文件。 在 LayoutModification.json 中指定的每个 Web 链接必须在 LayoutModification.xml 中具有对应的 SecondaryTile 元素:

  • LayoutModification.xml 用于配置 Web 链接
  • LayoutModification.json 引用配置的 Web 链接

重要

确保在映像中包含这两个 LayoutModification 文件。

创建 LayoutModification.xml

创建“开始”菜单布局 .xml 文件的最简单方法是在 Windows 10 参考电脑的“开始”菜单上添加网站链接,然后使用 PowerShell 导出布局。 如果要使用 Web 固定功能,则需要将导出的布局和 LayoutModification.json 都包含在映像中。

请参阅导出“开始”菜单布局了解如何导出“开始”菜单布局。

导出的“开始”菜单布局将包含已配置的每个 Web 链接的 SecondaryTile 元素。 请记下 AppUserModelIDTileID 元素。 将这些元素添加到 LayoutModification.json 以固定 Web 链接。

Web 固定项示例

下面是 LayoutModification.xml 中的一个 Web 固定项示例:

<start:SecondaryTile 
AppUserModelID="Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App" 
TileID="MSEdge.anfoedbkjbcacemdbigf.UserData.Default" 
Arguments="--launch-tile --profile-directory=Default --app-id=anfoedbkjbhcfgooaffkopcacemdbigf --app-url=https://www.bing.com/" 
DisplayName="(Text of your choice to display in Start)" 
Square150x150LogoUri="msappdata:///local/Favicons/Taskbar/‌anfoedbkjbhcfgooaffkopcacemdbigf/largefavicon.png" 
Wide310x150LogoUri="ms-appx:///" 
ShowNameOnSquare150x150Logo="true" 
ShowNameOnWide310x150Logo="false" 
BackgroundColor="#000000" 
Size="2x2" 
Row="0" 
Column="0"/> 

通过在要添加固定项的部分中添加新的 JSON 对象,将此磁贴添加到 LayoutModification.json:

  • AppUserModelID 中的属性 ("Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App") 用于 LayoutModification.json 中的 packagedAppID 值。
  • TileID 中的属性 ("MSEdge.anfoedbkjbcacemdbigf.UserData.Default") 用于 LayoutModification.json 中的 tileID 值。

下面是使用上述示例将 Web 链接固定到“已固定项”部分底部后的外观:

... 
"secondaryOEMPins": [ 
  { "packagedAppId": "Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App", 
    "tileId": "MSEdge.anfoedbkjbcacemdbigf.UserData.Default" }, 
  ], 
...

预先固定 Office

如果预装了 Office 即点即用 (C2R) 应用,Windows 会将这些应用自动固定到“开始”菜单。 使用 Office 预安装工具包 (OPK) 安装 C2R 版本的 Office,Windows 将自动检测 Office 安装并将相应的固定项添加到“开始”菜单。 并非每个 C2R Office 应用(只有 Word、Excel 和 PowerPoint)都会固定到“开始”菜单。 此行为是完全自动的,不需要 LayoutModification.json 中的任何内容。

如果未预装 C2R Office,固定到“开始”菜单的其他项将滑动以填充这些应用的位置,这样就不会在布局中间留下空隙。

将布局添加到映像

  1. 装载 Windows 映像。

    dism /mount-image /imagefile:E:\Sources\install.wim /mountdir:C:\mount /index:1
    
  2. LayoutModification.jsonLayoutModification.xml 复制到已装载的映像。 Windows 将在 \Windows\Users\Default\Appdata\Local\Microsoft\Windows\Shell 文件夹中查找这些文件。 如果该文件夹中已存在 layoutmodification.xml 文件,请将现有文件替换为新文件。

    xcopy /s LayoutModification.json C:\Mount\Users\Default\Appdata\Local\Microsoft\Windows\Shell
    xcopy /s LayoutModification.xml C:\Mount\Users\Default\Appdata\Local\Microsoft\Windows\Shell
    
  3. 卸载映像并提交更改。

    dism /unmount-image /mountdir:C:\mount /commit
    

描述文字的语言标记

下表包含用于 Windows 11 支持的每种语言的标记:

  • 如果知道语言/区域设置,请在第一列中搜索它,并使用第二列中的相应标记(注意:标记被视为区分大小写,因此请确保使用例如 en-US 而不是 en-us)。
  • 不要使用第三列中的标记。 但是,如果你认为自己使用的标记不正确,并且想要查找相应的正确标记,你可以尝试在第三列中搜索你尝试使用的标记,然后从第二列中查看正确的标记应该是什么。
Windows 语言 要在 LayoutModification.json 中使用的标记 旧式标记(如果与第二列不同,请勿使用)
南非荷兰语 af af-ZA
阿尔巴尼亚语 sq sq-AL
阿尔萨斯语 gsw gsw-CH
阿姆哈拉语 am am-ET
阿拉伯语(阿尔及利亚) ar-DZ ar-DZ
阿拉伯语(巴林) ar-BH ar-BH
阿拉伯语(埃及) ar-EG ar-EG
阿拉伯语(伊拉克) ar-IQ ar-IQ
阿拉伯语(约旦) ar-JO ar-JO
阿拉伯语(科威特) ar-KW ar-KW
阿拉伯语(黎巴嫩) ar-LB ar-LB
阿拉伯语(利比亚) ar-LY ar-LY
阿拉伯语(摩洛哥) ar-MA ar-MA
阿拉伯语(阿曼) ar-OM ar-OM
阿拉伯语(卡塔尔) ar-QA ar-QA
阿拉伯语(沙特阿拉伯) ar-SA ar-SA
阿拉伯语(叙利亚) ar-SY ar-SY
阿拉伯语(突尼斯) ar-TN ar-TN
阿拉伯语(阿拉伯联合酋长国) ar-AE ar-AE
阿拉伯语(也门) ar-YE ar-YE
亚美尼亚语 hy hy-AM
阿萨姆语 as as-IN
阿塞拜疆语(西里尔文) az-Cyrl az-Cyrl-AZ
阿塞拜疆语(拉丁语) az-Latn az-Latn-AZ
孟加拉语(孟加拉国) bn-BD bn-BD
巴什基尔语 ba-Cyrl ba-RU
巴斯克语 eu eu-ES
白俄罗斯语 be be-BY
孟加拉语(印度) bn-IN bn-IN
波斯尼亚语(西里尔文) bs-Cyrl bs-Cyrl-BA
波斯尼亚语(拉丁语系) bs bs-Latn-BA
布列塔尼语 br-Latn br-FR
保加利亚语 bg bg-BG
缅甸语 my my-MM
加泰罗尼亚语 ca ca-ES
宿务语(拉丁语,菲律宾) ceb-Latn-PH ceb-Latn-PH
中库尔德语 ku-Arab ku-Arab-IQ
查克马语(查克马语,孟加拉国) ccp-Cakm-BD ccp-Cakm-BD
查克马语(查克马语,印度) ccp-Cakm-IN ccp-Cakm-IN
切罗基语(切罗基) 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
柯西嘉语 co-Latn co-FR
克罗地亚语(波斯尼亚和黑塞哥维那) hr-BA hr-BA
克罗地亚语(克罗地亚) hr-HR hr-HR
捷克语 cs cs-CZ
丹麦语 da da-DK
达里语 prs-Arab prs-AF
马尔代夫语 dv dv-MV
荷兰语(比利时) nl-BE nl-BE
荷兰语(荷兰) nl-NL nl-NL
宗喀语 dz dz-BT
英语(澳大利亚) en-AU en-AU
英语(伯利兹) en-BZ en-BZ
英语(加拿大) en-CA en-CA
英语(加勒比海) en-029 en-029
英语(印度) en-IN en-IN
英语(爱尔兰) en-IE en-IE
英语(牙买加) en-JM en-JM
英语(马来西亚) en-MY en-MY
英语(新西兰) en-NZ en-NZ
英语(菲律宾) en-PH en-PH
英语(新加坡) en-SG en-SG
英语(南非) en-ZA en-ZA
英语(特立尼达和多巴哥) en-TT en-TT
英语(阿拉伯联合酋长国) en-AE en-AE
英语(英国) en-GB en-GB
英语(美国) zh-CN zh-CN
英语(津巴布韦) en-ZW en-ZW
爱沙尼亚语 et et-EE
法罗语 fo fo-FO
菲律宾语 fil-Latn fil-PH
芬兰语 fi fi-FI
法语(比利时) fr-BE fr-BE
法语(加拿大) fr-CA fr-CA
法语(加勒比海地区) fr-029 fr-029
法语(法国) fr-FR fr-FR
法语(卢森堡) fr-LU fr-LU
法语(摩纳哥) fr-MC fr-MC
法语(瑞士) fr-CH fr-CH
弗里西亚语 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
加利西亚语 gl gl-ES
格鲁吉亚语 ka ka-GE
德语(奥地利) de-AT de-AT
德语(德国) de-DE de-DE
德语(列支敦士登) de-LI de-LI
德语(卢森堡) de-LU de-LU
德语(瑞士) de-CH de-CH
希腊语 el el-GR
古吉拉特语 gu gu-IN
豪撒语(拉丁语) ha-Latn ha-Latn-NG
夏威夷语 haw-Latn haw-US
希伯来语 he he-IL
Hindi hi hi-IN
匈牙利语 hu hu-HU
冰岛语 is-IS
伊博语 ig-Latn ig-NG
伊纳里萨米语 smn-Latn smn-FI
印度尼西亚语 id id-ID
因纽特语(加拿大土著音节文字) iu-Cans iu-Cans-CA
因纽特语(拉丁语) iu-Latn iu-Latn-CA
爱尔兰语 ga ga-IE
爱尔兰语(英国) ga-GB ga-GB
科萨语 xh xh-ZA
祖鲁语 zu zu-ZA
意大利语(意大利) it-IT it-IT
意大利语(瑞士) it-CH it-CH
日语 ja ja-JP
基切语 quc-Latn quc-Latn-GT
格陵兰语 kl kl-GL
卡纳达语 kn kn-IN
哈萨克语 kk kk-KZ
高棉语 km km-KH
卢旺达语 rw rw-RW
斯瓦希里语 sw sw-KE
孔卡尼语 kok kok-IN
韩语 ko ko-KR
柯尔克孜语 ky-Cyrl ky-KG
老挝语 lo lo-LA
拉脱维亚语 lv lv-LV
立陶宛语 lt lt-LT
下索布语 dsb dsb-DE
律勒萨米语(挪威) smj-Latn-NO smj-NO
律勒萨米语(瑞典) smj-Latn-SE smj-SE
卢森堡语 lb lb-LU
马其顿语 mk mk-MK
马来语(文莱) ms-BN ms-BN
马来语(马来西亚) ms-MY ms-MY
马拉雅拉姆语 ml ml-IN
马耳他语 mt mt-MT
毛利语 mi-Latn mi-NZ
马普切语 arn-Latn arn-CL
马拉地语 mr mr-IN
摩霍克语 moh-Latn moh-CA
蒙古语(西里尔文) mn-Cyrl mn-MN
蒙古语(传统蒙古语) mn-Mong mn-Mong-CN
尼泊尔语(印度) ne-IN ne-IN
尼泊尔语(尼泊尔) ne-NP ne-NP
北萨米语(芬兰) se-Latn-FI se-FI
北萨米语(挪威) se-Latn-NO se-NO
北萨米语(瑞典) se-Latn-SE se-SE
挪威语(博克马尔语) nb nb-NO
挪威语(尼诺斯克语) nn nn-NO
奥克西唐语 oc-Latn oc-FR
奥里亚语 or-IN
普什图语 ps ps-AF
普什图语(巴基斯坦) ps-PK ps-PK
波斯语 fa fa-IR
波兰语 pl pl-PL
葡萄牙语(巴西) pt-BR pt-BR
葡萄牙语(葡萄牙) pt-PT pt-PT
旁遮普语(阿拉伯语) pa-Arab pa-Arab-PK
旁遮普语(果鲁穆齐语) pa pa-IN
克丘亚语(玻利维亚) quz-Latn-BO quz-BO
克丘亚语(厄瓜多尔) quz-Latn-EC quz-EC
克丘亚语(秘鲁) quz-Latn-PE quz-PE
罗马尼亚语(摩尔瓦多) ro-MD ro-MD
罗马尼亚语(罗马尼亚) ro-RO ro-RO
罗曼什语 rm rm-CH
俄语 ru ru-RU
萨哈语 sah-Cyrl sah-RU
梵语 sa-Deva sa-IN
苏格兰盖尔语 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
茨瓦纳语(博茨瓦纳) tn-BW tn-BW
茨瓦纳语(南非) tn-ZA tn-ZA
信德语(阿拉伯语) sd-Arab sd-Arab-PK
僧伽罗语 si si-LK
斯科特萨米语 sms-Latn sms-FI
斯洛伐克语 sk sk-SK
斯洛文尼亚语 sl sl-SI
南萨米语(挪威) sma-Latn-NO sma-NO
南萨米语(瑞典) sma-Latn-SE sma-SE
西班牙语(阿根廷) es-AR es-AR
西班牙语(玻利维亚) es-BO es-BO
西班牙语(智利) es-CL es-CL
西班牙语(哥伦比亚) es-CO es-CO
西班牙语(哥斯达黎加) es-CR es-CR
西班牙语(多米尼加共和国) es-DO es-DO
西班牙语(厄瓜多尔) es-EC es-EC
西班牙语(萨尔瓦多) es-SV es-SV
西班牙语(危地马拉) es-GT es-GT
西班牙语(洪都拉斯) es-HN es-HN
西班牙语(拉丁美洲) es-419 es-419
西班牙语(墨西哥) es-MX es-MX
西班牙(尼加拉瓜) es-NI es-NI
西班牙语(巴拿马) es-PA es-PA
西班牙语(巴拉圭) es-PY es-PY
西班牙语(秘鲁) es-PE es-PE
西班牙语(波多黎各) es-PR es-PR
西班牙语(西班牙) es-ES es-ES
西班牙语(美国) es-US es-US
西班牙语(乌拉圭) es-UY es-UY
西班牙语(委内瑞拉) es-VE es-VE
标准摩洛哥塔马赛特语 zgh-Tfng zgh-Tfng-MA
瑞典语(芬兰) sv-FI sv-FI
瑞典语(瑞典) sv-SE sv-SE
叙利亚语 syr-Syrc syr-SY
塔吉克语(西里尔文) tg-Cyrl tg-Cyrl-TJ
泰米尔语(印度) ta-IN ta-IN
泰米尔语(马来西亚) ta-MY ta-MY
泰米尔语(新加坡) ta-SG ta-SG
泰米尔语(斯里兰卡) ta-LK ta-LK
鞑靼语(西里尔文) tt-Cyrl tt-RU
泰卢固语 te te-IN
泰语 th th-TH
藏语 bo-Tibt bo-CN
提格里尼亚语(厄立特里亚) ti-ER ti-ER
提格里尼亚语(埃塞俄比亚) ti-ET ti-ET
土耳其语 tr tr-TR
土库曼语(拉丁语) tk-Latn tk-TM
乌克兰语 uk uk-UA
上索布语 hsb hsb-DE
乌尔都语(印度) ur-IN ur-IN
乌尔都语(巴基斯坦) ur-PK ur-PK
维吾尔语 ug-Arab ug-CN
乌兹别克语(西里尔文) uz-Cyrl uz-Cyrl-UZ
乌兹别克语(拉丁文) uz-Latn uz-Latn-UZ
巴伦西亚语 ca-ES-valencia ca-ES-valencia
越南语 vi vi-VN
威尔士语 cy cy-GB
沃洛夫语 wo-Latn wo-SN
彝语 ii-Yiii ii-CN
约鲁巴语 yo-Latn yo-NG

JSON 示例

下面的示例 JSON 代码片段展示了如何使用每个可用语言标记的示例

  • 对于已为其提供本地化文本的语言/区域设置,请将代码片段中的占位符语言名称替换为实际文本。

  • 对于不打算为其提供本地化文本的语言/区域设置,请删除代码片段中的相应行。 系统将回退到底部的 default 条目,以便为这些语言/区域设置显示该文本。

  • 对于具有多个区域设置变体的任何语言,可以仅指定主要标记(第一个连字符之前的部分)作为该语言所有其他区域设置的后备标记。 例如:

    "caption": {
    "en-US": "English (United States)", 
    "en-GB": "English (United Kingdom)", 
    "en": "text for all other locale variants of English"}
    

    这将专门为美国英语和英国英语提供文本,然后提供英语 (所有其他区域设置变体,例如。en-CA for Canada English) ,系统将使用“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"
}