🎧 음악을 쉽게 담다, Sqoop!

YouTube 영상 속 음악을 가져와 내 플레이리스트에 간편하게 저장하는 서비스

앱 & 팀 이름	Sqoop 스쿱 & Medio 미디오
로고
기간	2024. 09. 02 ~ 진행중
상태	앱스토어 배포 완료 및 업데이트 진행 중(v1.1.5)
참여 인원	7명(iOS 개발 4명 + 디자인 3명)
기술 스택	SwiftUI, MusicKit, ShazamKit, Swift Regex, Localization, SPM, Supabase
앱스토어	Sqoop 스쿱 - 유튜브 플리 변환
팀 인스타그램	medio_o.av

📱 앱 미리보기

링크 붙여넣기	추출 로딩 중	곡 변경 및 미리듣기	재검색	추천 플리

Sqoop 기능 흐름 도식

자세한 내용은 Wiki 페이지에서 확인하실 수 있습니다.

# 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 - MusicKit을 이용해 음악 검색, 재생 등 음악 관련 기능을 앱에서 구현할 수 있게 해주는 패키지입니다.
• ShazamExtractor - ShazamKit을 이용해 사용자가 YTPlaylistExtractor로 음원 추출에 실패 시 재검색 기능을 제공하는 패키지입니다.
• SQStorageService - 사용자가 스쿱한 플레이리스트를 외부 서버에 보관하여 여러 기능을 제공하는 패키지입니다.
• YTPlaylistExtractor - YouTube 플레이리스트의 정보(영상, 음악 메타데이터 등)를 추출하는 패키지입니다.