History: MediaPlayer (미디어 재생기) 플러그인

            ^이 페이지의 번역은 완료되지 않았습니다.^

! Media Player (미디어 재생기) 플러그인
''((Tiki3|티키3)) 에서 소개되었고, ((Tiki6|티키6)) 에서 [JQuery#Media] 과 함께 기능이 확장됨''

이 ((Wiki Plugin|위키 플러그인)) 은 위키 페이지 내부 혹은 기타 위키-문법이 활성화 된 기능에서 FLV 혹은 MP3 파일을 재생하거나, 혹은 ((Tiki6|티키6)) 이 후로, MP4, SWF, AVI, [http://tv.tiki.org/tiki-kaltura_video.php?mixId=0_lkgtny3n|WMV], RAM, MOV, MPEG, PDF 와 같은 다른 미디어 파일의 유형도 재생 가능하다, ... 이는 플래시 기반의 오픈 소스 미디어 재생기를 호출하여 이런 파일들을 재생한다.
{maketoc}
!! 상세내역
이 플러그인은 페이지 안에 간단한 MP3 혹은 FLV 재생기를 추가한다. 재생기 자체는 요구 사항이 아니다 (로컬에서 제공되지 않으면 웹에서 호출된다). 

사용되는 재생기는 다음 중 하나 일 수 있다:
[http://flash-mp3-player.net] (기본 mp3 재생기)
[http://flv-player.net] (기본 flv 재생기)

대체 재생기:
[http://code.google.com/p/mp3player]
[http://code.google.com/p/flvplayer/]

재생기 자체 (.swf 파일) 를 [http://flash-mp3-player.net] 혹은 [http://flv-player.net] 혹은 [http://code.google.com/p/mp3player] 혹은 [http://code.google.com/p/flvplayer/] 에서 다운로드할 수도 있다. 이럴 경우, 플러그인을 편집해야 하며 ( [http://tikiwiki.svn.sourceforge.net/viewvc/tikiwiki/trunk/lib/wiki-plugins/wikiplugin_mediaplayer.php?view=markup|lib/wiki-plugins/wikiplugin_mediaplayer.php]) 플러그인 코드 내부의 기본 소스를 변경하거나 이를 플러그인의 해당 인스턴스 내부의 "where" (어느 곳) 매개변수로써 추가하여야 한다.

!! 문제해결
* 재생기가 표시되지 않으면, 플러그인 매개변수 중 하나가 잘 못되어있을 가능성이 크다.
* 재생기가 표시되지만 재생을 하지 않으면, 파일에 대한 URL 이 틀렸을 수 있다.

!! 구문 예제
!!! MP3 ㅇ{ㅈ[
''파일 갤러리 내부에 있는 파일:''
{CODE(wrap=1)}
{mediaplayer mp3="display10"}
{mediaplayer mp3="tiki-download_file.php?fileId=389"}
{CODE}

''실제 파일 경로를 사용:''
{CODE(wrap=1)}{mediaplayer mp3="http://usuaris.tinet.org/mikell/EntrevistaRadio4.mp3"}
{mediaplayer mp3="http://usuaris.tinet.org/mikell/EntrevistaRadio4.mp3", style="mini"}
{mediaplayer mp3="/test.mp3", loop="1"}
{CODE}

{REMARKSBOX(title=팁 type=tip)}
''파일 갤러리로 업로드 되었지만 서버에 저장된 파일들에 대하여, 실제 파일 경로 또한 사용될 수 있다. 티키는 파일명을  서버 상의 저장소에 대한 해시 값 (hash value)로 변환한다 - 이 이름은 데이터베이스에서 발견될 수 있다.''
{REMARKSBOX}

!!! FLV 파일
''flv'' 및 ''type'' 매개변수를 사용하여 아래처럼 flv 파일들을 보여준다:

파일 갤러리의 flv 파일:
{CODE(wrap=1)}
 {mediaplayer flv="http://example.com/display10" type="flv"}
{CODE}

그 외의 경우 서버의 디렉터리로 파일을 업로드하고 직접 파일 경로를 사용하십시오. 파일에 .flv 확장자가 있는 경우, ''type'' (유형) 매개변수는 설정하지 않아도 됩니다:
{CODE(wrap="1")}
{mediaplayer flv="http://flv-player.net/medias/KyodaiNoGilga.flv"}
{CODE}

!! 플러그인 매개변수
[http://flash-mp3-player.net|http://flash-mp3-player.net|box] 및 [http://flv-player.net|http://flv-player.net|box] 에서 설명되는 매개변수 외에, 다음의 티키 매개변수를 사용할 수 있다:
{PLUGINPARAMS()}
''mp3''  |링크|  |y (flv 및 src 가 아닌 경우)  |MP3 파일 링크|
''flv''|링크 |  |y (mp3 및 src 가 아닌 경우)  |FLV 파일 링크|
''src''|링크| |y (flv 및 mp3 가 아닌 경우)|aif, aiff, aac, au, bmp, gsm, mov, mid, midi, mpg, mpeg, mp4, m4a, psd, qt, qtif, qif, qti, snd, tif, tiff, wav, 3g2, 3pg, swf,asx, asf, avi, wma, wmv,ra, ram, rm, rpm, rv, smi, smil, xaml, html, pdf 파일 링크(전체 목록은 [http://jquery.malsup.com/media|jQuery 미디어] 참조)|>=6.0
''style''|문자열|normal  |n|mini 혹은 normal 혹은 maxi 혹은 multi 스타일|
''where'' (MP3 용)  |url    |http://flash-mp3-player.net/medias/  |n      |재생기의 SWF 파일에 대한 URL ( / 로 끝남)|
''where'' (FLV 용)  |url    |http://flv-player.net/medias/    |n      |재생기의 SWF 파일로의 URL ( / 로 끝남)|
''wmode''    |문자열  |transparent          |n      |플래시 개체의 창 모드|5.x
{PLUGINPARAMS}

플래시 MP3 재생기 매개변수:
{FANCYTABLE(head="__이름__|__설명__" headaligns="center|center" headvaligns="middle|middle" colwidths="|80%" colaligns="right|justify" colvaligns="|middle")}
mp3      |재생될 MP3 파일의 URL
autoplay    |자동 재생하려면 1
loop    |루프 돌리려면 1
volume     |초기 음량, 0 과 200 사이.
skin    |로드 (progressive 아님)할 JPEG 파일의 URL
showstop   |STOP 버튼을 표시하려면 1
showinfo   |INFO 버튼을 표시하려면 1
loadingcolor   |로딩 막대기의 색상
bgcolor1   |배경 gradient 의 첫번째 색상
bgcolor2   |배경 gradient 의 두번재 색상
buttoncolor   |버튼 색상
buttonovercolor  |버튼의 Hover 색상
slidercolor1   |막대기 gradient 의 첫번재 색상
slidercolor2   |막대기 gradient 의 두번재 색상
sliderovercolor  |막대기의 Hover 색상
textcolor   |텍스트 색상
bgcolor     |배경 색상
byteslimit   |MP3 스트리밍의 경우, 스트림은 오버로드를 방지하기 위하여 bytes limit 에서 재시작할 것입니다. 
{FANCYTABLE}

!!! src 매개변수의 예제 (jQuery Media)
It has been enhanced in ((Tiki6)) with [jQuery#Media], so that more media formats are supported once you use the param "url" in the plugin helper ("src" in the code), including pdf among others. The value in the src parameter must end with a file extension 

Example:
{CODE(wrap=1)}{mediaplayer src="http://www.gnu.org/philosophy/fsfs/rms-essays.pdf", width=100%, height=600} {CODE}

''would produce:''

{mediaplayer src="http://www.gnu.org/philosophy/fsfs/rms-essays.pdf", width=100%, height=600}

!!! Other Examples
!!!! FLV
''This code:''
{CODE(wrap=1)}{mediaplayer flv="http://flv-player.net/medias/KyodaiNoGilga.flv"}{CODE}

''would produce:''
{mediaplayer flv="http://flv-player.net/medias/KyodaiNoGilga.flv"}

!!!! File gallery file in a blog post
An example for a successful use of the maxi Mediaplayer in a blog post looks like this (only caveat is to have access rights for the relevant user group by setting tiki_p_download_files to yes - sometimes, a restart of the browser seems to be necessary to make those rights work...)
{CODE(wrap="1")}
{mediaplayer mp3="http://example.com/tiki-download_file.php?fileId=1&showstop=1&showinfo=1&showvolume=1", style="maxi"}
{CODE}

!!!! PDF file in a file gallery
This also works for a pdf file in a file gallery beginning in version 10:
{CODE(wrap=1)}
{mediaplayer src="tiki-download_file.php?fileId=7&display=y" type="pdf"}
{CODE}
And it displays the PDF file with the ID 7.

{include page="Module and Plugin Includes" start="startinclude1" stop="stopinclude1"}
* ((PluginBlipTV))
* ((PluginVimeo))
* ((PluginWatershed))
* ((PluginYouTube))