혼합 미디어 뷰어가 표시하는 특정 콘텐츠는 현지화가 적용됩니다. 이 지침에는 확대/축소 단추, 스핀 단추, 비디오 컨트롤, 닫기 단추, 전체 화면 단추 및 견본 스크롤 단추가 포함되어 있습니다.
지역화할 수 있는 뷰어의 모든 텍스트 컨텐츠는 SYMBOL이라는 특수 Viewer 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.ROLE_DESCRIPTION |
기본 보기 구성 요소에 대한 ARIA 역할 설명입니다. |
SpinView.USAGE_HINT |
키보드 사용자에 대한 ARIA 사용 힌트입니다. |
FlyoutZoomView.ROLE_DESCRIPTION |
기본 보기 구성 요소에 대한 ARIA 역할 설명입니다. |
FlyoutZoomView.USAGE_HINT |
키보드 사용자에 대한 ARIA 사용 힌트입니다. |
CloseButton.TOOLTIP |
닫기 단추. |
ZoomInButton.TOOLTIP |
확대 단추. |
ZoomOutButton.TOOLTIP |
축소 단추. |
ZoomResetButton.TOOLTIP |
확대/축소 재설정 단추. |
FlyoutZoomView.TIP_BUBBLE_OVER |
의 데스크탑 시스템 인라인 확대/축소 모드. |
FlyoutZoomView.TIP_BUBBLE_TAP |
의 터치 장치 인라인 확대/축소 모드. |
FullScreenButton.TOOLTIP_SELECTED |
일반 상태의 전체 화면 단추. |
FullScreenButton.TOOLTIP_UNSELECTED |
전체 화면 상태의 전체 화면 단추. |
ClosedCaptionButton.TOOLTIP_SELECTED |
선택한 닫힌 캡션 단추 상태입니다. |
ClosedCaptionButton.TOOLTIP_UNSELECTED |
선택하지 않은 닫힌 캡션 단추 상태. |
ScrollLeftButton.TOOLTIP |
왼쪽으로 스크롤합니다. |
ScrollRightButton.TOOLTIP |
오른쪽 스크롤 단추. |
ScrollUpButton.TOOLTIP |
위로 스크롤합니다. |
ScrollDownButton.TOOLTIP |
아래로 스크롤합니다. |
PanLeftButton.TOOLTIP |
왼쪽 회전 단추. |
PanRightButton.TOOLTIP |
오른쪽 회전 단추. |
PlayPauseButton.TOOLTIP_SELECTED |
재생 일시 정지 단추 상태를 선택했습니다. |
PlayPauseButton.TOOLTIP_UNSELECTED |
재생 일시 정지 단추 상태를 선택 취소합니다. |
PlayPauseButton.TOOLTIP_REPLAY |
재생 일시 정지 단추 상태. |
VideoScrubber.TOOLTIP |
비디오 스크러버. |
VideoTime.TOOLTIP |
컨트롤 막대의 비디오 시간입니다. |
MutableVolume.TOOLTIP_SELECTED |
선택한 가변 볼륨 상태입니다. |
MutableVolume.TOOLTIP_UNSELECTED |
선택 취소된 가변 볼륨. |
MutableVolume.TOOLTIP_VOLUME |
ARIA를 통해 노출되는 볼륨 슬라이더 노브 레이블 aria-valuettext 속성을 사용합니다. |
VideoPlayer.ERROR |
비디오를 재생할 수 없을 때 표시되는 오류 메시지입니다. |