v1.3.0 후처리 기능 추가

README.md

@@ -11,9 +11,12 @@ SJVA에서 "시스템 → 플러그인 → 플러그인 수동 설치" 칸에
 
 다른 분들이 만든 플러그인을 참고하며 주먹구구식으로 만들었습니다;;  
 
-드디어! API를 추가했습니다. 다른 플러그인에서 동영상 정보나 다운로드를 요청할 수 있습니다.  
+API도 제공합니다. 다른 플러그인에서 동영상 정보나 다운로드를 요청할 수 있습니다.  
 다른 플러그인이 멋대로 다운로드를 중지할 수 없도록 다운로드를 요청할 때 임의의 키를 넘겨 받습니다. 이 중지 요청 시 키가 일치해야 요청이 실행됩니다.  
-이걸로 뭔갈 만드실 분이 계실지...
+과연 이걸로 뭔가를 만드실 분이 계실지...  
+
+일반적인 유튜브 오디오 비트레이트가 192kbps라서 오디오 추출 시 비트레이트를 192kbps로 설정했습니다.  
+API에선 직접 비트레이트를 설정할 수 있습니다.
 
 ## API
 ### 공통사항
@@ -30,13 +33,13 @@ SJVA에서 "시스템 → 플러그인 → 플러그인 수동 설치" 칸에
 * `10` - 실패. 요청은 성공하였으나 실행 결과가 실패
 #### Status 타입
 상태를 나타냄
-* "`READY`" - 준비
-* "`START`" - 분석중
-* "`DOWNLOADING`" - 다운로드중
-* "`ERROR`" - 실패
-* "`FINISHED`" - 변환중
-* "`STOP`" - 중지
-* "`COMPLETED`" - 완료
+* `"READY"` - 준비
+* `"START"` - 분석중
+* `"DOWNLOADING"` - 다운로드중
+* `"ERROR"` - 실패
+* `"FINISHED"` - 변환중
+* `"STOP"` - 중지
+* `"COMPLETED"` - 완료
 
 ### /youtube-dl/api/info_dict
 동영상 정보를 반환하는 API
@@ -53,7 +56,7 @@ SJVA에서 "시스템 → 플러그인 → 플러그인 수동 설치" 칸에
 
 동영상 정보(`info_dict` 키)에는 youtube-dl에서 생성한 info_dict 정보가 그대로 들어있습니다. 따라서 이 부분은 직접 주소를 넣어가며 반환되는 정보를 확인해보는게 좋습니다.  
 간단한 예로 `thumbnail` 키엔 썸네일 주소, `uploader` 키엔 업로더 이름, `title` 키엔 동영상 제목, `duration` 키엔 동영상 길이 등이 들어 있습니다.  
-그리고 만약 주소가 플레이리스트라면 `_type` 키에 "`playlist`"라는 값이 들어 있습니다. 이때는 `entries` 키에 리스트가 들어있어 동영상들의 제목과 ID를 확인할 수 있습니다.
+그리고 만약 주소가 플레이리스트라면 `_type` 키에 `"playlist"`라는 값이 들어 있습니다. 이때는 `entries` 키에 리스트가 들어있어 동영상들의 제목과 ID를 확인할 수 있습니다.
 
 ### /youtube-dl/api/download
 다운로드 준비를 요청하는 API
@@ -63,11 +66,14 @@ SJVA에서 "시스템 → 플러그인 → 플러그인 수동 설치" 칸에
 `plugin` | 플러그인 이름 | O | String
 `key` | 임의의 키. 이후 다운로드를 제어할 때 이 키가 필요함 | O | String
 `url` | 동영상 주소 | O | String
-`filename` | 파일명. 템플릿 규칙은 https://github.com/ytdl-org/youtube-dl/blob/master/README.md#output-template 참고. 기본값: 사용자 설정 | X | String
-`temp_path` | 임시 폴더 경로. 기본값: 사용자 설정 | X | String
-`save_path` | 저장 폴더 경로. 기본값: 사용자 설정 | X | String
-`format_code` | 동영상 포맷. 포맷 지정은 https://github.com/ytdl-org/youtube-dl/blob/master/README.md#format-selection 참고. 기본값: 최고 화질 | X | String
-`start` | 다운로드 준비 후 바로 다운로드를 시작할지 여부. 기본값: false | X | Boolean
+`filename` | 파일명. 템플릿 규칙은 https://github.com/ytdl-org/youtube-dl/blob/master/README.md#output-template 참고. 미지정 시 사용자 설정 | X | String
+`temp_path` | 임시 폴더 경로. 미지정 시 사용자 설정 | X | String
+`save_path` | 저장 폴더 경로. 미지정 시 사용자 설정 | X | String
+`format_code` | 동영상 포맷. 포맷 지정은 https://github.com/ytdl-org/youtube-dl/blob/master/README.md#format-selection 참고. 미지정 시 최고 화질 | X | String
+`preferedformat` | 변환할 비디오 포맷. 가능한 포맷은 https://ffmpeg.org/general.html#File-Formats 참고. 미지정 시 변환하지 않음 | X | String
+`preferredcodec` | 추출할 오디오 코덱. 가능한 값은 `"mp3"`, `"aac"`, `"flac"`, `"m4a"`, `"opus"`, `"vorbis"`, `"wav"`. 미지정 시 추출하지 않음 | X | String
+`preferredquality` | 추출한 오디오의 비트레이트. `preferredcodec` 키가 있을 때만 유효. 기본값: `"192"` | X | String
+`start` | 다운로드 준비 후 바로 다운로드를 시작할지 여부. 기본값: `false` | X | Boolean
 #### Response
 키 | 설명 | 타입
 --- | --- | ---
@@ -124,6 +130,11 @@ SJVA에서 "시스템 → 플러그인 → 플러그인 수동 설치" 칸에
 물론 해당 정보가 없으면 null입니다.
 
 ## Changelog
+v1.3.0
+* 후처리 기능 추가  
+  이제 비디오 변환이나 오디오 추출이 가능합니다.  
+  오디오 추출의 경우 비트레이트는 192kbps로 설정되어 있습니다.
+
 v1.2.5
 * 기본 파일명 설정 추가
 * API에서 일부 키를 선택으로 변경