윈도우11 시작메뉴 레이아웃 - windou11 sijagmenyu leiaus

주요 콘텐츠로 건너뛰기

이 브라우저는 더 이상 지원되지 않습니다.

최신 기능, 보안 업데이트, 기술 지원을 이용하려면 Microsoft Edge로 업그레이드하세요.

Windows 11 시작 레이아웃 사용자 지정

  • 아티클
  • 09/21/2022
  • 읽는 데 33분 걸림

이 문서의 내용

이 항목의 IT 전문가 버전을 찾고 계신가요? Windows 11 시작 메뉴 레이아웃 사용자 지정을 참조하세요.

OEM은 Windows 11 시작 레이아웃을 사용자 지정하여 OEM 정의 항목(앱 및/또는 웹 사이트)이 시작 메뉴의 특정 영역에 고정되도록 할 수 있습니다.

시작 레이아웃 사용자 지정은 LayoutModification.json 및 필요에 따라 LayoutModification.xml로 구성됩니다.

  • LayoutModification.json은 앱 핀을 완벽하게 지원합니다.
  • LayoutModification.xmlLayoutModification.json에 웹 사이트 핀을 추가할 수 있습니다.

참고

Windows 11 시작 메뉴는 Windows 구성 디자이너 또는 무인을 사용하여 구성할 수 없습니다.

시작 메뉴 섹션

시작 메뉴는 고정, 모든 앱 및 권장의 세 가지 섹션으로 구성됩니다. LayoutModification.json에는 고정 및/또는 권장 섹션에 대한 사용자 지정이 포함될 수 있습니다.

고정 섹션

시작 메뉴 맨 위에 있는 섹션을 고정 섹션이라고 합니다. 이 섹션은 그리드에 배열된 핀으로 구성됩니다. 이 섹션의 항목은 PC에 설치된 모든 앱의 하위 집합입니다. 설치된 모든 앱이 기본적으로 이 섹션에 포함되어 있지는 않습니다. 이 보기의 행 및 항목 수는 디바이스 패널 크기에서 일관됩니다.

이 섹션의 초기 보기에는 18개의 항목이 표시되지만 사용자는 페이지 매김 컨트롤을 사용하여 추가 핀 페이지를 이동할 수 있습니다. 이 섹션의 항목은 Microsoft 정의 앱, 동적으로 제공되는 앱, OEM 구성 항목의 조합입니다. 사용자는 PC를 설정한 후 이 섹션에서 핀을 추가, 이동 또는 제거할 수 있습니다.

사용 가능한 사용자 지정:

  • 이 섹션의 1페이지에 최대 4개의 항목이 있습니다. LayoutModification.json에서 primaryOEMPins로 구성됩니다.
  • 고정된 앱 그리드 하단에 최대 4개의 항목이 있습니다. 사용자는 이 핀을 보려면 시작 메뉴에서 아래로 스크롤해야 합니다. LayoutModification.json에서 secondaryOEMPins로 구성됩니다.

이 섹션 중 하나에 4개 미만의 항목을 고정하면 다른 Microsoft 정의 앱이 밀어서 공간을 채워 동일한 순서를 유지합니다. 처음 4개를 초과하는 모든 배열 요소는 무시됩니다.

참고

항목은 고정 섹션에 한 번만 나타날 수 있습니다. 같은 페이지에 있든 다른 페이지에 있든 앱을 이 섹션에 있는 둘 이상의 위치에 고정할 수 없습니다.

모든 앱 섹션

사용자가 시작 메뉴의 오른쪽 위 모서리에 있는 모든 앱을 클릭하면 표시됩니다. 모든 앱은 설치된 모든 앱을 알파벳 순서로 나열한 포괄적인 목록입니다.

사용 가능한 사용자 지정:

  • 이 섹션에 대한 사용자 지정이 없습니다. 모든 앱은 설치된 모든 앱을 포함하는 목록이며 사용자 또는 OEM에서 사용자 지정할 수 없습니다.

권장 섹션

이는 “고정” 섹션 아래에 있는 섹션입니다. 처음 부팅할 때 Microsoft의 시작하기 앱이 이 위치에 미리 채워집니다. OEM은 고객이 제거하지 않는 한 최대 7일 동안 고정된 상태로 유지되는 환영 또는 첫 실행 환경 앱으로 섹션을 미리 채울 수도 있습니다.

사용 가능한 사용자 지정: 이 섹션의 항목 1개. LayoutModification.json에서 firstRunOEMPins로 구성됩니다.

  • 가장 깨끗하고 최상의 사용자 환경을 위해 권장 섹션에서 선택한 앱이 작업 표시줄 또는 시작 핀의 첫 페이지에 미리 고정되지 않는 것이 좋습니다.

시작 메뉴 항목 사용자 지정

중요

WCD 또는 무인을 사용하여 Windows 11 시작 메뉴를 사용자 지정하는 것은 지원되지 않으므로 LayoutModification.json이 필요합니다.

OEM은 사용자 지정 LayoutModification.json 파일을 만들고 %localappdata%\Microsoft\Windows\Shell 폴더의 이미지에 추가하여 시작 레이아웃을 사용자 지정할 수 있습니다. 이미지에는 하나의 LayoutModification.json만 필요합니다. 이러한 파일은 어떤 조합으로든 하나 이상의 최상위 멤버를 포함할 수 있기 때문입니다.

웹 링크를 고정하는 경우 LayoutModification.json과 함께 사용할 LayoutModification.xml 파일도 만들어야 합니다.

중요

LayoutModification.json에서 UTF-8 인코딩을 사용해야 합니다.

LayoutModification.json

LayoutModification.json을 사용하면 시작 레이아웃의 사용자 지정 가능한 섹션 내에서 핀을 구성할 수 있습니다.

LayoutModification.json 멤버

멤버설명
primaryOEMPins "고정" 섹션의 1페이지에 표시되는 항목을 구성합니다. 형식을 조합하여 최대 4개의 항목을 지정할 수 있습니다.
secondaryOEMPins "고정" 섹션의 끝에 표시되는 항목을 구성합니다. 형식을 조합하여 최대 4개의 항목을 지정할 수 있습니다.
firstRunOEMPins "권장" 섹션에서 OEM 구성 가능 항목을 구성합니다. 하나의 항목을 지정할 수 있습니다.

LayoutModification.json 키

위의 각 멤버는 다음과 같은 가능한 멤버를 사용하여 각 섹션에 대한 핀을 정의할 수 있습니다.

Key설명
packagedAppID
  • 유니버설 Windows 플랫폼 앱을 지정합니다. UWP 앱을 고정하려면 앱의 AUMID를 사용합니다.
  • tileID 하위 요소와 함께 웹 링크를 지정하는 데 사용됩니다. 웹 링크 고정에 대한 내용은 웹 링크 고정을 참조하세요.
tileID packagedAppID에만 사용됩니다. 웹 링크를 고정할 때 LayoutModification.xml의 TileID에 해당합니다.
desktopAppID 패키지되지 않은 Win32 앱을 지정합니다. Win32 앱을 고정하려면 앱의 AUMID를 사용합니다. 앱에 AUMID가 없으면 대신 desktopAppLink를 대신 사용하여 지정합니다.
desktopAppLink 연결된 AUMID가 없는 패키지되지 않은 Win32 앱을 지정합니다. 이 유형의 앱을 고정하려면 앱을 가리키는 .lnk 바로 가기 경로를 사용합니다.
caption firstRunOEMPins 항목에만 적용됩니다. 사용자가 마우스로 타일 위를 가리킬 때 표시되는 텍스트 문자열입니다.

여러 언어가 포함된 이미지의 경우 사용자의 언어가 명시적으로 지정된 언어와 일치하지 않을 때 대체(fallback)로 사용되는 기본 캡션뿐만 아니라 언어별로 다른 텍스트를 지정할 수 있습니다(아래 예제 참조). 캡션 언어를 지정하는 방법에 대한 자세한 내용은 캡션 언어 태그를 참조하세요.

샘플 LayoutModification.json 파일

사용자 지정 가능한 세 가지 시작 메뉴 섹션에 대한 사용자 지정을 보여주는 샘플 LayoutModification.json 파일은 다음과 같습니다.

  • primaryOEMPins의 3개 항목: 1개 UWP 앱, 1개 Win32 앱 및 1개 웹 링크
  • secondaryOEMPins의 2개 항목: 1개 웹 링크 및 1개 Win32 앱
  • firstRunOEMPins의 1개 항목: 1개 Win32 앱(.lnk 파일로 지정됨)
{ "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에서 정적으로 정의한 자사 앱: 1페이지에 고정된 Microsoft 자사 앱(예: Microsoft Edge, 메일, Microsoft Store)은 OEM에서 이동할 수 없습니다. OEM에서 이러한 앱 중 하나를 1페이지에도 고정하려고 하면 무시됩니다.

  • 정적으로 정의된 Microsoft 자사 앱 상승: OEM은 1페이지에 Microsoft 자사 앱(예: 계산기, 카메라)을 고정하고 1페이지에서 Microsoft가 정적으로 고정하지 않았거나 고정되지 않은 한 해당 위치를 페이지 1로 이동할 수 있습니다.

웹 링크 고정

웹 링크를 시작 메뉴에 고정하려면 LayoutModification.jsonLayoutModification.xml 파일을 모두 사용해야 합니다.

웹 링크는 LayoutModification.xml 및 LayoutModification.json을 모두 사용합니다. LayoutModification.json에 지정된 각 웹 링크에는 LayoutModification.xml에 해당하는 SecondaryTile 요소가 있어야 합니다.

  • LayoutModification.xml은 웹 링크를 구성하는 데 사용됩니다.
  • LayoutModification.json은 구성된 웹 링크를 참조합니다.

중요

두 LayoutModification 파일을 모두 이미지에 포함해야 합니다.

LayoutModification.xml 만들기

시작 레이아웃 .xml 파일을 만드는 가장 쉬운 방법은 웹 사이트 링크를 Windows 10 참조 PC의 시작 메뉴에 추가한 다음, PowerShell을 사용하여 레이아웃을 내보내는 것입니다. 웹 고정을 사용하는 경우 내보낸 레이아웃 및 LayoutModification.json을 모두 이미지에 포함해야 합니다.

시작 레이아웃을 내보내는 방법에 대한 내용은 시작 레이아웃 내보내기를 참조하세요.

내보낸 시작 레이아웃을 사용하여 웹 링크 고정

내보낸 시작 레이아웃에는 구성한 각 웹 링크에 대한 SecondaryTile 요소가 포함됩니다. AppUserModelIDTileID 요소를 기록해 둡니다. 이러한 요소는 나중에 웹 링크를 고정시키기 위해 LayoutModification.json에 추가됩니다.

웹 핀 예제

LayoutModification.xml의 웹 핀 예제는 다음과 같습니다.

<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에 추가합니다.

  • LayoutModification.json의 packagedAppID 값에 대해 AppUserModelID("Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!App")의 특성을 사용합니다.
  • LayoutModification.json의 tileID 값에 대해 TileID("MSEdge.anfoedbkjbcacemdbigf.UserData.Default")의 특성을 사용합니다.

위의 예제를 사용하여 웹 링크를 "고정" 섹션의 아래쪽에 고정하는 방법은 다음과 같습니다.

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

Office 사전 고정

Office C2R(간편 실행) 앱이 사전 설치된 경우 Windows에서 이러한 앱은 시작 화면에 자동으로 고정됩니다. OPK(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.jsonLayoutModification.xml을 탑재된 이미지에 복사합니다. Windows는 \Windows\Users\Default\Appdata\Local\Microsoft\Windows\Shell 폴더에서 이러한 파일을 찾습니다. LayoutModification 파일이 이미 폴더에 있는 경우 기존 파일을 새 파일로 바꿉니다.

    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
Arabic (Bahrain) 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
Burmese 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
영어(미국) ko-KR en-US
영어(짐바브웨) 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
풀라어(Adlam, 부르키나파소) ff-Adlm-BF ff-Adlm-BF
풀라어(Adlam, 카메룬) ff-Adlm-CM ff-Adlm-CM
풀라어(Adlam, 감비아) ff-Adlm-GM ff-Adlm-GM
풀라어(Adlam, 가나) ff-Adlm-GH ff-Adlm-GH
풀라어(Adlam, 기니) ff-Adlm-GN ff-Adlm-GN
풀라어(Adlam, 기니비사우) ff-Adlm-GW ff-Adlm-GW
풀라어(Adlam, 라이베리아) ff-Adlm-LR ff-Adlm-LR
풀라어(Adlam, 모리타니) ff-Adlm-MR ff-Adlm-MR
풀라어(Adlam, 니제르) ff-Adlm-NE ff-Adlm-NE
풀라어(Adlam, 나이지리아) ff-Adlm-NG ff-Adlm-NG
풀라어(Adlam, 세네갈) ff-Adlm-SN ff-Adlm-SN
풀라어(Adlam, 시에라리온) 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
이그보어 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 항목으로 대체(fallback)합니다.

  • 여러 로캘 변형이 있는 언어의 경우 주 태그(첫 번째 하이픈 앞 부분)만 해당 언어의 다른 모든 로캘에 대한 대체(fallback)로 지정할 수 있습니다. 예를 들면 다음과 같습니다.

    "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"
}