# 🎧 음악을 쉽게 담다, Sqoop!
> YouTube 영상 속 음악을 가져와 내 플레이리스트에 간편하게 저장하는 서비스

|앱 & 팀 이름|Sqoop 스쿱 & Medio 미디오|
|:--:|:--|
|로고|<img width="70" alt="" src="./images/applogo.png"> <img width="130" alt="" src="./images/medio.png">|
|기간|2024. 09. 02 ~ 진행중|
|상태|앱스토어 배포 완료 및 업데이트 진행 중(v1.1.5)|
|참여 인원|7명(iOS 개발 4명 + 디자인 3명)|
|기술 스택|SwiftUI, MusicKit, ShazamKit, Swift Regex, Localization, SPM, Supabase|
|앱스토어|[Sqoop 스쿱 - 유튜브 플리 변환](https://apps.apple.com/kr/app/sqoop-%EC%8A%A4%EC%BF%B1/id6736636919)|
|팀 인스타그램|[medio_o.av](https://www.instagram.com/medio_o.av?igsh=MWtoNGZtY2IyNHRsbw==)|

<br/>

<br/>
<br/>

### 📱 앱 미리보기
|링크 붙여넣기|추출 로딩 중|곡 변경 및 미리듣기|재검색|추천 플리|
|:--:|:--:|:--:|:--:|:--:|
|<img width="130" alt="" src="./images/linkpaste.gif">|<img width="130" alt="" src="./images/sqooping.gif">|<img width="130" alt="" src="./images/songchange.gif">|<img width="130" alt="" src="./images/research.gif">|<img width="130" alt="" src="./images/recommand.gif">|

<br/>



# Sqoop 기능 흐름 도식
![Frame 1707481487](./images/appflow.png)

자세한 내용은 [Wiki 페이지](https://github.com/DeveloperAcademy-POSTECH/2024-MacC-M14-Medio/wiki)에서 확인하실 수 있습니다.

<br/>
# 1-1. Youtube 영상 URL 붙여넣기

- `SQServieStroge` - URL을 Unique Key값으로, 캐싱된 URL인지 확인. (캐싱되었다면, MusicKey 배열 반환)

# 1-2. Sqoop 추천 Playlist 선택

- `SQServieStroge` - 테이블 내 최신 10개의 플레이리스트 반환.
- `YTPlaylistExtractor` - YouTube API를 통한 채널 정보 및 댓글 리스트 반환.

# 2-1. Youtube 영상 내 정보를 바탕으로 곡 정보 추출

**영상 플레이리스트**

- `YTPlaylistExtractor` - 캐싱되지 않았다면, YouTube API의 Description을 정규표현식과 매칭해 MusicList 추출(titelOrArtists)
- `YTPlaylistExtractor` - Description에 존재하지 않는다면, YouTube API의 CommentList를 정규표현식과 매칭해 MusicList 추출(titleOrArtists)
- `YTPlaylistExtractor` - YouTube API의 전체 영상 길이를 이용한 음악 추정 시간(estimateDuration) 계산

**공식 플레이리스트**

- `YTPlaylistExtractor` - 캐싱되지 않았다면, YouTube API의 Playlist 정보의 각 제목 및 채널명을 이용한 MusicList 추출

# 2-2. 이미 정보가 DB에 있을 시

- `SQServiceStorage`를 이용하여 Youtube 영상 URL을 기반한 Youtube Playlist ID를 외부 서버 DB에 검색하여 이미 Playlist 정보를 확인
- `SQServiceStorage` 에 이미 저장되어 있다면 Playlist를 반환 - SQServiceStorage API 관련 링크 넣기

# 3-1. 곡 메타 데이터 기반 곡 생성 및 편집

**곡 고유 아이디 기반**

- `MKMusicCrafter` - 2가지 타입의 메타 데이터 정보를 애플 뮤직 곡으로 변환
    - 메타데이터 타입: 1. 음악 고유 ID 기반 | 2. 음악 제목, 아티스트 정보 기반
- `MKMusicCrafter` 내부 API를 통하여 사용자에게 플레이리스트 수정, 검색, 삭제를 제공

# 3-2. 유저가 추출한 정보가 미흡하다고 판단 시

- `MKMusicCrafter`에서 검색 후 추출한 곡 정보가 미흡하거나 추출한 곡이 없을 경우, 재검색 버튼을 통해 Shazam 검색을 진행.

# 4. Shazam 검색 결과를 바탕으로 곡 정보 추출

`ShazamExtractor`를 통해

1. Shazam 검색을 진행할 대상 영상 URL에서 Audio 파일 추출
2. Audio 파일을 2분마다 12초씩 Shazam 검색이 가능한 형태의 객체(SHSignature)로 변환
    - ex) 0:00~0:12, 2:00~2:12, 4:00~4:12, 6:00~6:12,…
3. SHSignature들로 Shazam 검색 진행
4. 추출한 곡 정보들을 `MKMusicCrafter`에 Apple Music Song ID 전송

# 5. 곡 정보 기반 곡 생성 및 편집

1. `ShazamExtractor`로부터 받은 Apple Music Song ID들로 `MKMusicCrafter`에서 곡 검색
2. 검색된 결과(Song 객체)들을 `MKMusicCrafter`에서 편집 후 Apple Music으로 전송

### 📦 모듈 설명
- [MKMusicCrafter](https://github.com/DeveloperAcademy-POSTECH/2024-MacC-M14-Medio/wiki/MKMusicCrafter) - MusicKit을 이용해 음악 검색, 재생 등 음악 관련 기능을 앱에서 구현할 수 있게 해주는 패키지입니다.
- [ShazamExtractor](https://github.com/DeveloperAcademy-POSTECH/2024-MacC-M14-Medio/wiki/ShazamExtractor) - ShazamKit을 이용해 사용자가 YTPlaylistExtractor로 음원 추출에 실패 시 재검색 기능을 제공하는 패키지입니다.
- [SQStorageService](https://github.com/DeveloperAcademy-POSTECH/2024-MacC-M14-Medio/wiki/SQStorageService) - 사용자가 스쿱한 플레이리스트를 외부 서버에 보관하여 여러 기능을 제공하는 패키지입니다.
- [YTPlaylistExtractor](https://github.com/DeveloperAcademy-POSTECH/2024-MacC-M14-Medio/wiki/YTPlaylistExtractor) - YouTube 플레이리스트의 정보(영상, 음악 메타데이터 등)를 추출하는 패키지입니다.