사용자 인터페이스 요소의 현지화

마지막 업데이트: 2023-11-03
  • 주제:
  • Dynamic Media Classic
    이 항목에 대한 자세한 내용 보기
  • Viewers
    이 항목에 대한 자세한 내용 보기
  • SDK/API
    이 항목에 대한 자세한 내용 보기
  • Video
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • Developer
    User

비디오 뷰어에 표시되는 특정 컨텐츠는 현지화가 적용됩니다. 이 콘텐츠에는 사용자 인터페이스 요소 도구 팁과 비디오를 재생할 수 없을 때 표시되는 오류 메시지가 포함되어 있습니다.

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

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

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

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

{
"en":{
"VideoPlayer.ERROR":"Your Browser does not support HTML5 Video tag or the video cannot be played.",
"PlayPauseButton.TOOLTIP_SELECTED":"Play"
 },
 "fr":{
"VideoPlayer.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.TOOLS_SELECTED

선택한 재생 일시 중지 단추 상태에 대한 도구 설명입니다.

PlayPauseButton.TOOLTIP_UNSELECTED

선택 취소된 재생 일시 중지 단추 상태에 대한 도구 설명입니다.

PlayPauseButton.TOOLTIP_PLAY

재생 일시 중지 단추 상태에 대한 도구 설명입니다.

VideoScrubber.TOOLTIP

비디오 스크러버용 도구 설명

VideoTime.TOOL팁

컨트롤 막대의 비디오 시간에 대한 도구 설명입니다.

MutableVolume.TOOLTIP_SELECTED

선택한 변경 가능한 볼륨 상태에 대한 도구 설명입니다.

MutableVolume.TOOLTIP_UNSELECTED

선택 취소된 변경 가능 볼륨에 대한 도구 설명.

MutableVolume.TOOLTIP_VOLUME

ARIA를 통해 노출된 볼륨 슬라이더 노브 레이블 aria-valuetext 특성.

FullScreenButton.TOOLS_SELECTED

선택한 전체 화면 버튼 상태에 대한 도구 설명입니다.

FullScreenButton.TOOLS_UNSELECTED

선택 취소된 전체 화면 버튼 상태에 대한 도구 설명입니다.

ClosedCaptionButton.TOOLTIP_SELECTED

선택한 닫힌 캡션 단추 상태에 대한 도구 설명입니다.

ClosedCaptionButton.TOOLTIP_UNSELECTED

선택 취소된 닫힌 캡션 단추 상태에 대한 도구 설명입니다.

SocialShare.TOOLTIP

소셜 공유 도구에 대한 도구 팁입니다.

EmailShare.TOOLS 팁

이메일 공유 단추에 대한 도구 설명입니다.

EmailShare.HEADER

이메일 대화 상자 헤더의 도구 설명

EmailShare.TOOLTIP_HEADER_CLOSE

이메일 대화 상자의 오른쪽 위 닫기 단추에 대한 도구 설명입니다.

EmailShare.INVALID_ADDRESSS

이메일 주소 형식이 잘못된 경우 표시되는 오류 메시지에 대한 도구 설명.

EmailShare.TO

"받는 사람" 입력 필드에 대한 레이블입니다.

EmailShare.TOOLTIP_ADD

"다른 이메일 주소 추가" 버튼에 대한 도구 설명.

EmailShare.ADD

"다른 이메일 주소 추가" 버튼 캡션

EmailShare.FROM

"보낸 사람" 입력 필드에 대한 레이블입니다.

EmailShare.MESSAGE

"메시지" 입력 필드에 대한 레이블입니다.

EmailShare.TOOLTIP_REMOVE

"이메일 주소 제거" 단추에 대한 도구 설명.

EmailShare.CANCEL

"취소" 단추의 캡션.

EmailShare.TOOLTIP_CANCEL

"취소" 단추에 대한 도구 설명입니다.

EmailShare.Close

양식 제출 후 대화 상자 하단에 표시되는 닫기 단추의 캡션입니다.

EmailShare.TOOLTIP_CLOSE

양식 제출 후 대화 상자 하단에 표시되는 닫기 단추에 대한 도구 팁입니다.

EmailShare.ACTION

양식 제출 단추의 캡션입니다.

EmailShare.TOOLTIP_ACTION

양식 제출 단추에 대한 도구 설명입니다.

EmailShare.SEND_SUCCESS

이메일을 성공적으로 보냈을 때 표시되는 확인 메시지입니다.

EmailShare.SEND_FAILURE

이메일을 정상적으로 보내지 못했을 때 표시되는 오류 메시지.

EmbedShare.TOOLTIP

공유 포함 단추에 대한 도구 설명입니다.

EmbedShare.HEADER

포함 대화 상자 헤더의 도구 설명

EmbedShare.TOOLTIP_HEADER_CLOSE

포함 대화 상자의 오른쪽 위 닫기 단추에 대한 도구 설명입니다.

EmbedShare.DESCRIPTION

포함 코드 텍스트에 대한 설명입니다.

EmbedShare.EMBED_SIZE

포함 크기 콤보 상자의 레이블입니다.

EmbedShare.CANCEL

"취소" 단추의 캡션.

EmbedShare.TOOLS_CANCEL

"취소" 단추에 대한 도구 설명입니다.

EmbedShare.ACTION

"모두 선택" 단추의 캡션

EmbedShare.TOOLTIP 작업

[모두 선택] 단추 툴팁

EmbedShare.CUSTOM_SIZE

포함 크기 콤보 상자의 마지막 "사용자 지정 크기" 항목에 대한 텍스트입니다.

LinkShare.TOOLTIP

링크 공유 단추에 대한 도구 설명입니다.

LinkShare.HEADER

링크 대화 상자 헤더의 도구 설명

LinkShare.TOOLTIP_HEADER_CLOSE

링크 대화 상자의 오른쪽 위 닫기 단추에 대한 도구 설명입니다.

LinkShare.DESCRIPTION

공유 링크에 대한 설명입니다.

LinkShare.CANCEL

"취소" 단추의 캡션.

LinkShare.TOOLS_CANCEL

"취소" 단추에 대한 도구 설명입니다.

LinkShare.ACTION

"모두 선택" 단추의 캡션

LinkShare.TOOLTIP 작업

[모두 선택] 단추 툴팁

FacebookShare.TOOLTIP

facebook 공유 단추에 대한 도구 설명입니다.

TwitterShare.TOOLTIP

twitter 공유 단추에 대한 도구 설명입니다.

VideoPlayer.오류

비디오 재생이 가능하지 않을 때 표시되는 오류 메시지에 대한 도구 설명.

이 페이지의