共用方式為

自定義 Windows 11 \[開始\] 配置

  • 發行項

尋找本主題的 IT 專業人員版本嗎？ 請參閱在 Windows 11 上自定義 [開始] 功能表 版面配置

提示

如需本主題的 Windows 10 版本，請參閱 自定義 Windows 10 開始版面配置

OEM 可以自定義 Windows 11 \[開始\] 配置，以便 OEM 定義的專案（應用程式和/或網站）釘選在 [開始] 功能表 的某些區域中。

[開始] 版面配置自定義專案，包括網站釘選的設定，都是使用 LayoutModification.json來設定。

注意

您無法使用 Windows 設定設計工具或自動安裝來設定 Windows 11 [開始] 選單。

[開始] 功能表 區段

[開始] 功能表 是由三個區段所組成：已釘選、所有應用程式和建議。 您的LayoutModification.json可以包含釘選和/或建議區段的自定義專案。

釘選區段

[開始] 功能表 頂端的 區段稱為 [釘選] 區段。 本節包含方格中排列的針腳。 本節中的專案是計算機上安裝的所有應用程式子集;並非所有已安裝的應用程式預設都會包含在本節中。 此檢視中的數據列和項目數目在裝置面板大小之間是一致的。

雖然本節的初始檢視會顯示18個專案，但使用者可以使用分頁控件來移動其他針腳的頁面。 本節中的專案包括Microsoft定義的應用程式、動態傳遞的應用程式，以及 OEM 設定的專案。 設定計算機之後，使用者可以在此區段中新增、移動或移除釘選。

可用的自訂項目：

  • 本節第 1 頁最多四個專案。 在 LayoutModification.json 設定 primaryOEMPins 。
  • 釘選應用程式方格底部最多四個專案。 用戶必須在 [開始] 功能表 向下卷動，才能看到這些釘選。 在 LayoutModification.json 設定 secondaryOEMPins 。

如果您在這兩個區段中釘選少於四個專案，其他Microsoft定義的應用程式將會滑過以填滿空間，以維持相同的順序。 將忽略前四個以外的任何陣列元素。

注意

專案只能出現在 [釘選] 區段中一次。 您無法在本節中的多個位置釘選應用程式，不論是在同一個頁面或不同頁面上。

所有應用程式區段

當使用者按兩下 [開始] 功能表 右上角的[所有應用程式] 時，就會出現此情況。 所有應用程式都是所有已安裝應用程式的完整清單，依字母順序排列。

可用的自訂項目：

  • 本節沒有自定義專案。 所有應用程式都是包含所有已安裝應用程式且無法由使用者或 OEM 自定義的清單。

這是「釘選」區段下方的區段。 在第一次開機時， 會在此位置預先填入來自Microsoft的開始使用應用程式 。 OEM 也可以預先填入區段，其中包含歡迎或初次執行體驗應用程式，除非客戶將其移除，否則將持續釘選最多七天。

可用的自定義：本節中的一個專案。 在 LayoutModification.json 設定 firstRunOEMPins 。

  • 為了獲得最佳且最簡潔的用戶體驗，我們建議針對 [建議] 區段選擇的應用程式不會預先釘選到任務欄或開始釘選的第一頁。

自訂 [開始] 功能表專案

重要

不支援使用 WCD 或自動安裝來自定義 Windows 11 [開始] 功能表，LayoutModification.json是必要的。

OEM 可以藉由建立自定義 LayoutModification.json 檔案並將它新增至資料夾中的映像， %localappdata%\Microsoft\Windows\Shell 來自定義 \[開始\] 配置。 您只需要映像中的一個 LayoutModification.json ，因為這些檔案可以包含任意組合中的一或多個最上層成員。

重要

請確定您的LayoutModification.json使用UTF-8編碼。

LayoutModification.json

LayoutModification.json 可讓您在 \[開始\] 配置的可自定義區段內設定釘選。

LayoutModification.json成員

member 描述
primaryOEMPins 設定顯示在 [釘選] 區段第 1 頁的專案。 您可以指定最多四個專案，以任何類型的組合。
secondaryOEMPins 設定出現在 [釘選] 區段結尾的專案。 您可以指定最多四個專案，以任何類型的組合。
firstRunOEMPins 在 [建議] 區段中設定 OEM 可設定的專案。 您可以指定一個專案。

LayoutModification.json鍵

上述每個成員都可以使用下列可能的成員來定義每個區段的釘選：

關鍵 描述
packagedAppID
  • 指定 通用 Windows 平台 應用程式。 若要釘選 UWP 應用程式，請使用應用程式的 AUMID。
  • 也可以當做內部 secondaryTile 的子元素使用，以指定 Weblink。 請參閱 釘選網頁連結。
desktopAppID 指定未封裝的 Win32 應用程式。 若要釘選 Win32 應用程式，請使用應用程式的 AUMID。 如果應用程式沒有 AUMID，請改用 desktopAppLink 加以指定。
desktopAppLink 指定沒有相關聯 AUMID 的未封裝 Win32 應用程式。 若要釘選這種類型的應用程式，請使用指向應用程式之.lnk快捷方式的路徑。
標題 僅適用於 firstRunOEMPins 專案。 當使用者將滑鼠停留在磚上方時顯示的文字字串。

針對包含多種語言的影像，您可以指定不同語言的不同文字（如下列範例所示），以及當用戶的語言不符合任何明確指定語言時，用來做為後援的默認標題。 如需如何指定標題語言的詳細資訊，請參閱 標題 的語言標籤。
secondaryTile 請參閱 釘選網頁連結。
tileID 針對每個 次要磚產生的唯一標識符。 僅用於指定次要磚。

範例LayoutModification.json檔案

以下是範例LayoutModification.json檔案，其中顯示三個可自定義 [開始] 功能表 區段的自定義：

  • 中的 primaryOEMPins三個專案：一個UWP應用程式、一個Win32應用程式和一個 Web連結
  • 中的 secondaryOEMPins兩個專案：一個網頁連結和一個 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 頁的應用程式，無法由 OEM 移動。 如果 OEM 嘗試在第 1 頁釘選其中一個應用程式，則會予以忽略。

  • 提升靜態定義Microsoft第一方應用程式：OEM 可以在第 1 頁釘選Microsoft第一方應用程式（例如計算機、相機），並將其位置移至第 1 頁，只要它尚未由第 1 頁的 Microsoft 靜態釘選，或未釘選。

若要將網頁連結釘選到 [開始] 功能表，您必須在 中LayoutModification.json指定 secondaryTile 元素。 若要這樣做，最簡單的方式是使用Edge將網站釘選到 [開始] 功能表，然後使用PowerShell匯出 \[開始\] 配置。

使用 Edge 釘選網站

流覽至您想要釘選的網站。 按兩下 [Edge] 工具列 [三個點] 選單，選取 [其他工具] > > ，然後選取 [釘選到開始]。

匯出 \[開始\] 配置

請參閱 匯出開始配置 ，以瞭解如何匯出開始配置。 您匯出的 \[開始\] 設定將包含 secondaryTile 您已設定之每個網頁連結的元素。 然後，您可以將此新增至您的自定義 LayoutModification.json 檔案。

範例 Web 釘選

以下是來自LayoutModification.json的 Web 釘選範例：

{
    "secondaryTile": {
        "tileId": "MSEdge._pin_mbfkklhhpckngkihcgoamfamci",
        "arguments": " --pin-url=https://learn.microsoft.com/ --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>"
    }
}

注意

從 Export-StartLayout 導出的次要磚將會包含大型和小型圖示的base64編碼影像。 您可以依原樣使用此 JSON 代碼段，而不需修改 OEM 設定。 將這個磚新增至LayoutModification.json，方法是在您要新增釘選的區段中新增 JSON 物件。 以下是使用上述範例將 Web 鏈接釘選到 「Pinned」 區段底部的樣子：

... 
"primaryOEMPins": [
    {
        "packagedAppId": "Contoso_8wekyb3d8bbwe!App"
    },
    {
        "secondaryTile": {
            "tileId": "MSEdge._pin_mbfkklhhpckngkihcgoamfamci",
            "arguments": " --pin-url=https://learn.microsoft.com/ --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>"
        }
    }
]
...

預先釘選 Office

如果預安裝應用程式，Office 隨選即用 （C2R） 應用程式會自動釘選到 Windows 啟動。 使用 Office 預安裝套件安裝 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.json 掛接的映像。 Windows 會在 \Windows\Users\Default\Appdata\Local\Microsoft\Windows\Shell 資料夾中尋找此檔案。 如果資料夾中已有版面配置修改檔案，請將現有的檔案取代為新的檔案。

    xcopy /s LayoutModification.json 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 舊樣式的標籤 （如果與第 2 欄不同，請勿使用）
南非荷蘭文 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-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-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-TW zh-TW
英文 (辛巴威) 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
印度文 hi hi-IN
匈牙利文 hu hu-HU
冰島文 is 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
K’iche’ 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
Mapuche 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-Y iii 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），系統會使用 “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"
}