플레이어 옵션 조회
- 인쇄
- PDF
플레이어 옵션 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
플레이어에 설정된 옵션을 조회하는 방법은 다음과 같습니다.
요청
요청 파라미터
필드명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
---|---|---|---|---|
player_no | Y | Integer | Path Parameter | 플레이어 번호 |
응답
필드명 | 타입 | 설명 | 비고 |
---|---|---|---|
result | Object | ||
result.env | String | 환경 | |
result.options | String(json) | 설정된 옵션 |
플레이어 옵션 정보
필드명 | 필수 여부 | 타입 | 제한 | 설명 |
---|---|---|---|---|
player_no | Y | Integer | 플레이어 번호 | |
option | Y | Object(json) | 플레이어 옵션 정보 | |
option.aspectRatio | N | String | 무/유료 | 화면비, 기본값: 16/9, 옵션: 16/9 , 4/3 , 1/1 , 9/16 , 21/9 |
option.autoPause | N | Boolean | 무/유료 | 비활성화 시 재생 자동 멈춤 |
option.autostart | N | Boolean | 무/유료 | 자동 재생 여부, 기본값: TRUE |
option.repeat | N | Boolean | 무/유료 | 영상 반복, 기본값: FALSE |
option.lang | N | String | 무/유료 | UI 언어 설정, 기본값: auto 옵션: auto , ko , en , ja |
option.muted | N | Boolean | 무/유료 | 음소거, 기본값: FALSE |
option.objectFit | N | String | 무/유료 | 영상 화면 맞춤, 기본값: contain, 옵션: contain , cover , fill |
option.controlActiveTime | N | Integer | 무/유료 | 컨트롤바 활성 시간(ms) 기본값: 3000 |
option.controls | N | Boolean | 무/유료 | 컨트롤바 사용 여부 , 기본값: TRUE |
option.controlBtn | N | Object | 유료 | 컨트롤바 버튼 노출 여부 설정 , 유료만 변경 가능 |
option.controlBtn.fullscreen | N | Boolean | 유료 | 전체 화면, 유료만 변경 가능 , 기본값: TRUE |
option.controlBtn.pictureInPicture | N | Boolean | 유료 | 미니 플레이어, 유료만 변경 가능 , 기본값: TRUE |
option.controlBtn.play | N | Boolean | 유료 | 플레이 버튼 노출, 유료만 변경 가능 , 기본값: TRUE |
option.controlBtn.times | N | Boolean | 유료 | 시간 표시, 유료만 변경 가능 , 기본값: TRUE |
option.controlBtn.volume | N | Boolean | 유료 | 볼륨 조절, 유료만 변경 가능 , 기본값: TRUE |
option.controlBtn.setting | N | Boolean | 유료 | 설정 버튼 노출, 유료만 변경 가능 , 기본값: TRUE |
option.controlBtn.subtitle | N | Boolean | 유료 | 자막 제어 버튼 노출, 유료만 변경 가능 , 기본값: TRUE |
option.controlBtn.progressBar | N | Boolean | 유료 | 재생바 사용 여부, 유료만 변경 가능, 기본값: TRUE |
option.descriptionNotVisible | N | Boolean | 유료 | 영상 메타 데이터 UI 숨기기, 유료만 메타데이터 설정 가능, 기본값: FALSE |
option.playRateSetting | N | Array | 유료 | 배속 선택 옵션 유료만 변경 가능 , 기본값: [0.5,0.75,1,1.5,2] |
option.progressBarColor | N | String | 유료 | 컨트롤바 컬러, 유료만 변경 가능 기본값: #4299f5 |
option.seekingPreview | N | Boolean | 유료 | 영상 구간 이동 미리보기, 기본값 TRUE |
option.setStartTime | N | String | 유료 | 최초 공개일 |
option.startMutedInfoNotVisible | N | Boolean | 유료 | 음소거 알림, 기본값: FALSE |
option.keyboardShortcut | N | Boolean | 유료 | 키보드 단축키 여부, 기본값: TRUE |
option.touchGestures | N | Boolean | 유료 | 터치 제스쳐 활성 |
option.ui | N | String | 유료 | UI 설정, 기본값 all 유료만 옵션 설정 가능: all, mobile, pc |
option.lowLatencyMode | N | Boolean | 유료 | LL-HLS 초지연 모드 대응, LIVE 영상을 항상 최신 구간으로 유지 기본값: FALSE |
option.customBtns | N | Array | 유료 | 커스텀 버튼 추가 (최대 4개) |
option.customBtns.ui | Y | String | 유료 | 커스텀 버튼 디바이스 환경 UI (PC, MOBILE) |
option.customBtns.position | Y | String | 유료 | 커스텀 버튼 위치 설정 (left-top, left-bottom, right-top, right-bottom |
option.customBtns.flow | N | String | 유료 | 커스텀 버튼 생성 위치 설정 (left, right, 기본값: left) |
option.customBtns.icon | Y | String | 유료 | 커스텀 버튼 이미지 URL 설정 |
요청 예시
성공 코드
HttpStatusCode | Code | Message |
---|---|---|
200 | 200 | ok |
에러 코드
HttpStatusCode | Code | Message | Description |
---|---|---|---|
200 | 4601 | Query string player_no is missing. | |
200 | 4801 | No player information. |
응답 예시
이 문서가 도움이 되었습니까?