mp3hls¶

/usr/local/m2/setting.json 다음 영역에 대해 기술한다.

{
  "functions": {
    "network": {
      "mp3hls": {
        ...
      }
    }
  }
}

How to use¶

명령어 리스트¶

용량제한 없는 HLS를 제공한다.

# 인덱스 파일을 제공한다.
https://foo.com/audio.mp3/mp3hls/index.m3u8
https://foo.com/audio.mp3/mp3hls/playlist.m3u8

# 분할된 미디어 파일을 mp3 또는 mpeg2-ts로 전송한다.
https://foo.com/audio.mp3/mp3hls/0.ts
https://foo.com/audio.mp3/mp3hls/1.ts
https://foo.com/audio.mp3/mp3hls/0.mp3
https://foo.com/audio.mp3/mp3hls/1.mp3

에러 메시지¶

See also

origin.log

응답코드	`x-sc-chain-error` 필드	설명
원본응답	`not200`	원본에서 `200 OK` 를 응답받지 못함
원본응답	`invalidseq`	잘못된 HLS 인덱스 번호
원본응답	`invalidtag`	잘못된 MP3 Tag 사이즈
원본응답	`invalidframe`	잘못된 MP3 Frame 사이즈
원본응답	`failtrim`	MP3 분할실패
원본응답	`toosmall`	원본이 최소구성크기(8bytes) 미만
원본응답	`failcache`	원본콘텐츠 캐시로딩 실패
`415`	`failparse`	MP3 분석실패
`415`	`failseek`	MP3 탐색실패
`415`	`failsegmp3`	HLS/MP3 분할실패
`415`	`failgenmp3`	HLS/MP3 생성실패
`415`	`noaudio`	오디오를 찾을 수 없음
`415`	`failinits`	HLS/MPEG2-TS 초기화실패
`415`	`failgents`	HLS/MPEG2-TS 생성실패

meta¶

"meta" : {
  "enable": false,
  "keyword": "mp3hls"
}

enable (기본: false): MP3편집 활성화
keyword (기본: mp3hls): MP3편집 키워드

hls¶

"hls" : {
  "duration": 10,
  "indexName": "index.m3u8",
  "segmentType": "ts",
  "insertPcr": false,
  "playlist": {
    "version": 3,
    "alternates": false,
    "alternatesName": "playlist.m3u8",
    "sequence": 0
  }
}

duration (기본: 10초)

MP3를 HLS로 분할하는 기준 시간(초)

indexName (기본: "index.m3u8)

HLS 인덱스(.m3u8) 파일명

segmentType (기본: TS)

원본 MP3를 TS (MPEG2-TS) 또는 MP3 로 분할한다.

insertPcr (기본: false)

설정이 true 면 TS (MPEG2-TS)에 PCR 필드를 추가한다.

playlist

인덱스 파일 구성

version (기본: 3): 인덱스 파일 버전
alternates (기본: false): Stream Alternates 사용여부.
alternatesName (기본: "playlist.m3u8): Stream Alternates 파일명.
sequence (기본: 0): .ts 또는 .mp3 파일의 시작 번호. 이 수를 기준으로 순차적으로 증가한다.

encrypt¶

EXT-X-KEY 암호화를 지원한다.

"encrypt": {
  "enable": false,
  "keyword": "segment.key",
  "token": "",
  "tokenType": null
}

enable (기본: false)

암호화 활성화

keyword (기본: "segment.key)

인덱스 파일에 표기될 암호화 키워드

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-KEY:METHOD=AES-128,URI="/sample.mp3/mp3hls/segment.key"
#EXTINF:10.677,
...

token

암호화 토큰

tokenType (기본: null)

암호화 토큰 타입

null 설정된 token 이 암호화 키로 사용한다.
enc 설정된 token 이 encryptpassword 로 암호화되어 있다. 사용시 복호화하여 사용한다.