사용자 인터페이스 요소의 현지화 localization-of-user-interface-elements

혼합 미디어 뷰어가 표시하는 특정 콘텐츠는 현지화가 적용됩니다. 이 지침에는 확대/축소 단추, 회전 단추, 비디오 컨트롤, 닫기 단추, 전체 화면 단추 및 견본 스크롤 단추가 포함되어 있습니다.

현지화할 수 있는 뷰어의 모든 텍스트 콘텐츠는 SYMBOL이라는 특수한 뷰어 SDK 식별자에 의해 표현됩니다. 모든 SYMBOL에는 영어 로케일에 대한 기본 연관 텍스트 값( "en") 기본 제공 뷰어와 함께 제공됩니다. 또한 필요한 수만큼 로케일에 대해 사용자 정의 값이 설정되어 있을 수 있습니다.

뷰어가 시작되면 현재 로케일을 확인하여 로케일에 대해 지원되는 각 SYMBOL에 대한 사용자 정의 값이 있는지 확인합니다. 있는 경우 사용자 정의 값을 사용하고, 그렇지 않은 경우 기본 텍스트로 돌아갑니다.

사용자 정의 로컬라이제이션 데이터를 로컬라이제이션 JSON 개체로 뷰어에 전달할 수 있습니다. 이러한 객체에는 지원되는 로케일 목록, 각 로케일에 대한 SYMBOL 텍스트 값 및 기본 로케일이 포함됩니다.

이러한 현지화 객체의 예는 다음과 같습니다.

{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
 },
 "fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}

위의 예에서 현지화 개체는 두 개의 로케일( "en""fr")에서 각 로케일의 두 가지 사용자 인터페이스 요소에 대한 현지화 기능을 제공합니다.

웹 페이지 코드는 로컬라이제이션 개체를 의 값으로 뷰어 생성자에 전달해야 합니다. localizedTexts 구성 객체의 필드입니다. 다른 옵션은 를 호출하여 현지화 개체를 전달하는 것입니다. setLocalizedTexts(localizationInfo) 메서드를 사용합니다.

지원되는 기호는 다음과 같습니다.

기호
다음에 대한 도구 설명...
Container.LABEL
최상위 뷰어 요소에 대한 ARIA 레이블입니다.
ZoomView.ROLE_DESCRIPTION
기본 보기 구성 요소에 대한 ARIA 역할 설명입니다.
ZoomView.USAGE_HINT
키보드 사용자에 대한 ARIA 사용 힌트입니다.
SpinView.역할 설명
기본 보기 구성 요소에 대한 ARIA 역할 설명입니다.
SpinView.USAGE_HINT
키보드 사용자에 대한 ARIA 사용 힌트입니다.
FlyoutZoomView.역할 설명
기본 보기 구성 요소에 대한 ARIA 역할 설명입니다.
FlyoutZoomView.USAGE_HINT
키보드 사용자에 대한 ARIA 사용 힌트입니다.
CloseButton.TOOLTIP
닫기 단추.
ZoomInButton.TOOL팁
확대 단추.
ZoomOutButton.TOOL팁
축소 단추.
ZoomResetButton.TOOLTIP
확대/축소 재설정 단추.
FlyoutZoomView.TIP_BUBBLE_OVER
의 데스크탑 시스템 인라인 확대/축소 모드.
FlyoutZoomView.TIP_BUBBLE_TAP
터치 장치 인라인 확대/축소 모드.
FullScreenButton.TOOLS_SELECTED
정상 상태의 전체 화면 단추.
FullScreenButton.TOOLS_UNSELECTED
전체 화면 상태의 전체 화면 단추.
ClosedCaptionButton.TOOLTIP_SELECTED
캡션 닫기 단추 상태를 선택했습니다.
ClosedCaptionButton.TOOLTIP_UNSELECTED
선택 해제한 닫힌 캡션 단추 상태.
ScrollLeftButton.TOOL팁
왼쪽으로 스크롤 단추.
ScrollRightButton.TOOL팁
오른쪽으로 스크롤 단추.
ScrollUpButton.TOOLTIP
위로 스크롤 단추.
ScrollDownButton.TOOLTIP
아래로 스크롤 단추.
PanLeftButton.TOOL팁
왼쪽으로 회전 단추.
오른쪽으로 패닝.툴팁
오른쪽으로 회전 단추.
PlayPauseButton.TOOLS_SELECTED
재생 일시 중지 단추 상태를 선택했습니다.
PlayPauseButton.TOOLTIP_UNSELECTED
재생 일시 중지 단추 상태를 선택 해제했습니다.
PlayPauseButton.TOOLTIP_PLAY
재생 일시 중지 단추 상태.
VideoScrubber.TOOLTIP
비디오 스크러버.
VideoTime.TOOL팁
컨트롤 막대의 비디오 시간입니다.
MutableVolume.TOOLTIP_SELECTED
볼륨 상태를 변경할 수 있도록 선택했습니다.
MutableVolume.TOOLTIP_UNSELECTED
변경 가능한 볼륨을 선택 해제했습니다.
MutableVolume.TOOLTIP_VOLUME
ARIA에 의해 노출된 볼륨 슬라이더 손잡이 레이블 aria-valuetext 특성.
VideoPlayer.오류
비디오 재생이 가능하지 않을 때 표시되는 오류 메시지.
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8