혼합 미디어 뷰어가 표시하는 특정 콘텐츠는 현지화가 적용됩니다. 이 지침에는 확대/축소 단추, 회전 단추, 비디오 컨트롤, 닫기 단추, 전체 화면 단추 및 견본 스크롤 단추가 포함되어 있습니다.
현지화할 수 있는 뷰어의 모든 텍스트 콘텐츠는 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.오류 |
비디오 재생이 가능하지 않을 때 표시되는 오류 메시지. |