동영상 배포 URL은 API를 호출하여 사용자가 콘텐츠를 볼 수 있게 하는 URL입니다.
배포 URL을 확인하는 방법에는 다음과 같은 두 가지가 있습니다.
1. URL을 조합하는 방법
URL을 조합하는 방법은 동영상 인코딩 상태 조회 API에서 리턴 받은 key값을 URL에 추가하여 영상을 호출하는 방법입니다.
WECANDEO key에 대한 내용을 함께 참고하시기 바랍니다.
2. 동영상 배포 코드 조회 API
동영상 배포코드 조회 API를 사용하는 방법은 인코딩 된 후 서비스가 가능해진 시점부터 동영상 배포 코드 조회 API로 Play URL을 확인할 수 있습니다.
curl -H "x-api-key: {API Key}" https://api.v4.wecandeo.com/info/videopack/publish/v1/info.json?accessKey={access_key}&packageId={package id}
{
"videoPublishInfo":{
"videoUrl": "https://{DOMAIN}/video/file?key=ii8rFc1a4f74ip5dhYQbipiilBuZqes3oMpJ",
"videoKey": "ii8rFc1a4f74ip5dhYQbipiilBuZqes3oMpJ",
"videoPageUrl": "https://{DOMAIN}/play/video/v?key=ii8rFc1a4f74ip5dhYQbipiilBuZqes3oMpJ",
"videoFileList":[
{"videoFileUrl": "https://{DOMAIN}/video/file?key=ii8rFc1a4f74ip5dhYQbipiilAphJKaBN4EipJJQrxGy7VG2qJcY499seUwieie",…},
{"videoFileUrl": "https://{DOMAIN}/video/file?key=ii8rFc1a4f74ip5dhYQbipiilAphJKaBN4EipJJQrxGy7VG0THjXBpKgzdQieie",…},
{"videoFileUrl": "https://{DOMAIN}/video/file?key=ii8rFc1a4f74ip5dhYQbipiilAphJKaBN4EipJJQrxGy7VG2Fy2iiipvtPo7wieie",…}
]
}
}
배포 주소의 종류
videoPageUrl
- WECANDEO 플레이어 URL(사용자 환경에 따라 지정된 화질, 포맷이 적용되는 동영상 URL)
- [VIDEOPACK > 배포 > 배포 패키지 > 해당 패키지 선택 > 배포 설정 > 디바이스 배포 설정]에서 사용자 환경에 따른 화질, 포맷을 지정할 수 있습니다.
- 플레이어에 시청자 통계수집기능이 내장되어 있어 플레이어 통계가 자동으로 수집됩니다.
https://{DOMAIN}/play/video/v?key={videoKey}
videoUrl
- videoUrl은 비디오 리소스 URL입니다.
- WECANDEO Player를 사용하지 않는 고객은 외부 플레이어를 사용하기 위해 videoUrl을 이용하실 수 있습니다.
- videoUrl 은 다음 두가지 타입 ( PATH, PARAM ) 으로 구분할 수 있으며, 두개가 동일한 기능을 가지고 있습니다.
- 통계수집기능은 VIDEO STATISTICS GUIDE를 참조하시어 구현하셔야 됩니다.
- VIDEO URL PARAM TYPE
videoUrl PARAM :: https://{DOMAIN}/video/file?key={videoKey}
- VIDEO URL PATH TYPE
videoUrl PATH :: https://{DOMAIN}/video/file/default/{videoKey}
videofilePageUrl
- WECANDEO Player URL(특정 화질, 포맷 동영상의 URL)
- 플레이어에 시청자 통계수집기능이 내장되어 있습니다.
https://{DOMAIN}/play/video/v?key={videoFileKey}
videofileUrl
- videofileUrl은 특정 화질, 포맷의 비디오 리소스 URL입니다.
- WECANDEO Player를 사용하지 않는 고객은 외부 플레이어를 사용하기 위해 videoUrl을 사용하실 수 있습니다.
- 통계수집기능은 VIDEO STATISTICS GUIDE를 참조하여 구현하여야 합니다.
http://{DOMAIN}/video/file/default/{videoFilekey}