XE 공식 자료실
- 제작자
- 후하니
- 등록일
- 2019-08-22
- 다운로드 수
- 1,148
- 링크1
- dev17.dnip.co.kr/index.php?mid=ncs
- 링크2
- huhani/xe-simple-mp3-player
이 애드온은 게시글에 mp3, m4a, ogg, flac, mp4, webm 파일이 첨부되어 있을 경우 파일의 태그를 자동 분석하여 자동으로 본문에 플레이어를 삽입합니다.
특히 mp3파일 같은 경우, 자체 HLS방식을 사용하여 엠넷, 지니뮤직, 네이버 뮤직 등과 같이 실시간으로 스트리밍합니다.
- 라이선스
- GPL v3
- 설치경로
- ./addons/simple_mp3_player
- 최초 등록일
- 2019-08-10
- 전체 다운로드
- 1,386
쉬운설치로 바로 체험할 수 있습니다
상세 설명
애드온 소개
이 애드온은 게시글에 mp3, m4a, ogg, flac, mp4, webm파일이 첨부되어 있을 경우 자동으로 플레이어를 생성해주는 프로그램입니다.
mp3파일의 경우 단순히 프로그래시브 방식이 아닌 자체 HLS방식을 이용하여 실시간으로 재생합니다.
특징
- MP3, M4A, OGG, FLAC파일을 첨부하였을 경우, 자동으로 파일의 태그를 분석하여 플레이어에 표시.
- 분석한 파일 태그의 앨범 커버를 자동으로 게시글 섬네일에 적용 기능.
- mp3 파일을 업로드 후 본문삽입된 하이퍼링크를 Audio 태그로 전환.
- 안드로이드 Notification에서 재생중인 곡 조절 기능.
- 오디오 파일 URL 암호화
- MP3를 자체 HLS 방식을 이용하여 음원 추출 예방.
- 재생/일시정지시 Fade In/Out 기능 (BluePlayer 사용시)
- AutoStation 기능을 이용하여 곡이 끝났을 경우 자동으로 AJAX를 이용하여 다음 글의 곡을 이어 재생 (BluePlayer 사용시)
- 재생 목록에 곡 재생시간을 함께 표시 (BluePlayer 사용시)
- 동영상 재생 (애드온 설정에서 활성화 필요)
- 동영상 반복, 자동재생 설정
- 오디오가 없는 동영상의 경우 gif처럼 재생.
- 본문에 삽입된 동영상 자동 리사이징 기능
플레이어
- APlayer (통합 플레이어)
- BluePlayer (통합 플레이어)
- 안드로이드 알림창에서 오디오 제어
- 첨부된 파일로부터 본문에 삽입된 오디오 링크를 오디오 태그로 변환
- 첨부된 파일로부터 본문에 삽입된 비디오 링크를 비디오 태그로 변환
업데이트 내역
1.1.1 - MediaSource Extension을 이용하여 재생할 때 Fetch API를 사용 가능할 경우, XHR대신 Fetch를 사용하게 변경.
1.1.0 - 게시글에 mp4, webm파일을 첨부하였을 경우 본문에 삽입 기능 추가.
- 오디오가 없는 비디오 파일은 자동으로 gif파일처럼 출력되는 기능 추가.
- 브라우저 창의 크기가 변경되었을 경우 반응형으로 본문 사이즈 너비에 맞게 자동 리사이징.
- 실시간 mp3 재생시 기본버퍼 50초로 상향 수정.
사용시 주의사항
1. 이 애드온은 다음과 같은 환경에서 테스트되었습니다.
- xe 1.8.27 (php 5.4)
- xe 1.11.5 (php 7.2, win64)
- xe 1.11.5 (php 7.0)
2. 애드온 작동에 관련된 파일들은 ./files/simple_mp3_player 에 생성이 됩니다.
3. APlayer는 기본적으로 가로 크기가 본문 너비의 100%로 설정되어 있습니다. (fixed 버전 제외)
따로 게시판 스킨단에서 사이즈 조절이 필요 할 수 있습니다.
4. ./addons/simple_mp3_player에 쓰기 권한이 없을 경우 URL암호화가 적용되지 않습니다.
5. simple_mp3_player 애드온 폴더에 __password.php같은 경우 URL암호화를 위해 자동으로 생성되는 파일입니다.
6. mp3파일 링크를 자동으로 HTML5 플레이어로 변환하는 기능은 ck에디어테서 작동 테스트를 하였으며, 그 외 에디터(xpresseditor 등)에선 지원하지 않을 수 있습니다.
7. 모든 파일은 플레이어 최초 로딩시 분석에 의해 조금의 딜레이가 발생 할 수 있습니다만, 파일 갯수가 많을수록 지연시간이 길어질 수 있습니다. (통상적으로 4분짜리 mp3파일 20개에 2초)
8. mp3파일의 경우 실시간 스트리밍을 위해 정밀 분석을 합니다. mp3파일의 프레임이 중간에 깨져있을 경우 정상적인 재생이 불가능할 수 있습니다.
9. 태그가 UTF8이 아닌 경우 깨져서 나올 수 있습니다. 이런 경우 mp3tag와 같은 프로그램으로 수정 적용하시면 해결됩니다.
10. 모바일 안드로이드의 경우 절전모드일때 스트리밍중인 앱(크롬, 삼성 브라우저 등)의 백그라운드 데이터 사용이 되지 않을 경우 원할한 스트리밍이 어려울 수 있습니다.
11. '애드온 설정 -> 대상' 설정에서 작동방식이 '선택한 모듈에서 사용'인 상태에서 대상 모듈이 하나라도 체크가 되어있을 경우 제대로 작동하지 않을 수 있습니다. 만약 제외해야 할 모듈이 있다면 '선택한 모듈에서 사용안함'으로 한 다음에 대항 모듈에 체크해주세요.