뷰어가 표시하는 특정 콘텐츠는 현지화의 대상이 됩니다. 이러한 컨텐츠에는 비디오를 재생할 수 없을 때 표시되는 오류 메시지와 사용자 인터페이스 요소 도구 설명이 포함됩니다.
지역화할 수 있는 뷰어의 모든 텍스트 컨텐츠는 SYMBOL이라는 특수 Viewer SDK 식별자로 표시됩니다. 모든 SYMBOL에는 기본 제공 뷰어와 함께 제공되는 영어 로케일( "en"
)에 대한 기본 관련 텍스트 값이 있습니다. 또한 필요한 만큼 많은 로케일에 대해 사용자 정의 값을 설정할 수도 있습니다.
뷰어가 시작되면 현재 로케일을 확인하여 로케일에 대해 지원되는 각 SYMBOL에 대해 사용자 정의 값이 있는지 확인합니다. 가 있는 경우 사용자 정의 값을 사용합니다. 그렇지 않으면 기본 텍스트로 돌아갑니다.
사용자 정의 로컬라이제이션 데이터를 로컬라이제이션 JSON 개체로 뷰어에 전달할 수 있습니다. 이러한 객체에는 지원되는 로케일 목록, 각 로케일의 SYMBOL 텍스트 값 및 기본 로캘이 포함되어 있습니다.
이러한 현지화 객체의 예는 다음과 같습니다.
{
"en":{
"Video360Player.ERROR":"Your Browser does not support HTML5 Video tag or the video cannot be played.",
"PlayPauseButton.TOOLTIP_SELECTED":"Play"
},
"fr":{
"Video360Player.ERROR":"Votre navigateur ne prend pas en charge la vidéo HTML5 tag ou la vidéo ne peuvent pas être lus.",
"PlayPauseButton.TOOLTIP_SELECTED":"Jouer"
},
defaultLocale:"en"
}
위의 예에서 현지화 개체는 두 로케일( "en"
및 "fr"
)을 정의하고 각 로케일의 두 사용자 인터페이스 요소에 대한 현지화를 제공합니다.
웹 페이지 코드는 구성 개체의 localizedTexts
필드 값으로 로컬라이제이션 개체를 뷰어 생성자에 전달해야 합니다. 다른 옵션은 setLocalizedTexts(localizationInfo)
메서드를 호출하여 현지화 개체를 전달하는 것입니다.
지원되는 기호는 다음과 같습니다.
기호 |
도구 설명... |
---|---|
Container.LABEL |
최상위 뷰어 요소에 대한 ARIA 레이블입니다. |
PlayPauseButton.TOOLTIP_SELECTED |
재생 일시 정지 단추 상태를 선택했습니다. |
PlayPauseButton.TOOLTIP_UNSELECTED |
재생 일시 정지 단추 상태를 선택 취소합니다. |
PlayPauseButton.TOOLTIP_REPLAY |
재생 일시 정지 단추 상태. |
VideoScrubber.TOOLTIP |
비디오 스크러버. |
VideoTime.TOOLTIP |
컨트롤 막대의 비디오 시간입니다. |
MutableVolume.TOOLTIP_SELECTED |
선택한 가변 볼륨 상태입니다. |
MutableVolume.TOOLTIP_UNSELECTED |
선택 취소된 가변 볼륨. |
MutableVolume.TOOLTIP_VOLUME |
ARIA aria-valueext 속성을 통해 노출되는 볼륨 슬라이더 노브 레이블입니다. |
FullScreenButton.TOOLTIP_SELECTED |
일반 상태의 전체 화면 단추. |
FullScreenButton.TOOLTIP_UNSELECTED |
전체 화면 상태의 전체 화면 단추. |
SocialShare.TOOLTIP |
소셜 공유 도구. |
EmbedShare.TOOLTIP |
포함 공유 단추입니다. |
EmbedShare.HEADER |
포함 대화 상자 헤더입니다. |
EmbedShare.TOOLTIP_HEADER_CLOSE |
포함 대화 상자의 오른쪽 상단 닫기 단추입니다. |
EmbedShare.DESCRIPTION |
포함 코드 텍스트입니다. |
EmbedShare.EMBED_SIZE |
포함 크기 콤보 상자. |
EmbedShare.CANCEL |
"취소" 단추. |
EmbedShare.TOOLTIP_CANCEL |
"취소" 단추. |
EmbedShare.ACTION |
모두 선택 단추. |
EmbedShare.TOOLTIP 작업 |
모두 선택 단추. |
EmbedShare.CUSTOM_SIZE |
포함 크기 콤보 상자의 마지막 "사용자 지정 크기" 항목입니다. |
LinkShare.TOOLTIP |
링크 공유 단추입니다. |
LinkShare.HEADER |
링크 대화 상자 헤더입니다. |
LinkShare.TOOLTIP_HEADER_CLOSE |
링크 대화 상자가 오른쪽 위에 있는 닫기 단추입니다. |
LinkShare.DESCRIPTION |
공유 링크. |
LinkShare.CANCEL |
"취소" 단추. |
LinkShare.TOOLTIP_CANCEL |
"취소" 단추. |
LinkShare.ACTION |
모두 선택 단추. |
LinkShare.TOOLTIP 작업 |
모두 선택 단추. |
FacebookShare.TOOLTIP |
facebook 공유 단추입니다. |
TwitterShare.TOOLTIP |
twitter 공유 단추입니다. |
Video360Player.ERROR |
비디오를 재생할 수 없을 때 나타나는 오류 메시지입니다. |