Music DJ: Spotify, YouTube, 로컬 음악

Music DJ는 장면에 어울리는 배경 음악을 재생합니다. 이 가이드에서는 Spotify, YouTube 또는 직접 가진 오디오 파일을 연결하고, 음악 플레이어를 쓰고, Game Mode(게임 모드)와 Conversation(대화)에서 음악을 쓰는 방법을 설명합니다.

Music DJ란

Music DJ는 선택해서 설치하는 다운로드 가능한 에이전트입니다. 에이전트는 채팅 뒤에서 실행되는 도우미입니다. 답변이 나올 때마다 장면의 분위기를 읽고 어울리는 음악을 재생할 수 있습니다.

시작하기 전에 Agents(에이전트)를 열고 Agent Organizer를 선택해 Music DJ를 설치하세요. 설치 직후에는 꺼져 있습니다. 다른 에이전트처럼 채팅마다 켜세요. Roleplay(롤플레이) 채팅에서 동작하고, Game Mode에서는 별도 토글로(Game Mode의 Music DJ), Conversation에서는 Music(음악) 명령어로(Conversation의 Music 명령어) 동작합니다.

세 가지 소스에서 재생합니다.

소스필요한 계정비용어울리는 경우
Spotify본인 Spotify 계정, 재생하려면 Spotify Premium설정은 무료, 재생은 Premium 필요실제 곡을 이름 그대로 내 기기에서 재생
YouTube무료 Google API 키무료로그인도 Premium도 없이 재생
Custom없음무료직접 가진 오디오 파일

현재 소스는 상단 바에 고정된 작은 Music Player(음악 플레이어)로 표시됩니다. 휴대폰이나 좁은 창에서는 끌어서 옮길 수 있는 작은 원형 플로팅 위젯이 됩니다.

Music DJ 설정은 한곳에서 공유합니다. 오른쪽 Agents 패널을 열고 Music DJ를 여세요. 미니 플레이어의 톱니바퀴 아이콘(툴팁 Music DJ setup(Music DJ 설정))을 클릭해도 됩니다.

음악 소스 고르기

Music DJ 편집기의 Music Player 항목에는 Spotify, YouTube, Custom 버튼 3개가 있습니다. 그 아래 줄에는 현재 동작 중인 소스가 표시됩니다. 예를 들면 "Visible player: Spotify. Saved provider: Spotify."입니다. 이 선택은 채팅별로 저장되지 않고 앱 전체에서 공유됩니다.

Spotify 설정

Spotify는 무료로 만드는 본인의 Spotify 개발자 앱을 사용합니다. 붙여 넣는 값은 Spotify Client ID(Spotify 클라이언트 ID) 하나뿐입니다. 클라이언트 시크릿은 없습니다.

  1. Music DJ 편집기에서 Spotify Connection(Spotify 연결)을 찾으세요.
  2. 앱에 표시된 링크로 Spotify Developer Dashboard를 여세요.
  3. 새 앱을 만들고 "Web API"를 선택하세요.
  4. 그 앱의 Redirect URIs에 앱 안 설정 상자의 3단계에서 Marinara가 보여 주는 리디렉션 주소를 그대로 추가하세요. 리디렉션 주소는 로그인한 뒤 Spotify가 사용자를 보내는 주소입니다.
  5. Client ID(클라이언트 ID)를 복사해 Spotify Client ID에 붙여 넣으세요.
  6. 에이전트를 저장한 다음 Connect Spotify Account(Spotify 계정 연결)를 클릭하세요.

Spotify 로그인과 권한 허용 창이 열립니다. 승인하면 짧은 성공 페이지가 표시된 뒤 창이 닫힙니다. Marinara에 초록색 Connected to Spotify(Spotify 연결됨) 배지가 표시됩니다. Disconnect(연결 해제)는 저장된 연결을 지웁니다.

참고: 재생, 일시 정지, 건너뛰기, 볼륨 조절에는 Spotify Premium(유료 요금제)이 필요합니다. 무료 계정으로도 연결은 됩니다. 토큰은 자동으로 갱신됩니다.

작동하지 않는 경우: 다른 컴퓨터에서는 로그인 창이 실패할 수 있습니다(아래 참고). 그렇지 않다면 리디렉션 주소가 정확히 일치하는지 확인하세요.

Spotify 기기

Spotify는 휴대폰, 데스크톱 Spotify 앱, 앱 안의 플레이어 같은 기기를 통해 재생합니다.

다른 컴퓨터에서 쓰는 Spotify

Spotify는 보안 https:// 리디렉션 주소나 루프백 주소 http://127.0.0.1(같은 컴퓨터)만 받아들입니다. Marinara가 다른 컴퓨터에서 일반 http로 실행되면 로그인 창이 실패할 수 있습니다. 해결 방법은 두 가지입니다.

SPOTIFY_REDIRECT_URI=https://your-address/api/spotify/callback

서버 설정 참고 문서를 참고하세요.

Spotify가 곡을 고를 곳 정하기(Roleplay)

Roleplay 채팅에서 Music DJ가 실행되면 카드에 Spotify source(Spotify 소스) 목록이 생깁니다.

YouTube 설정

YouTube 모드에는 무료 YouTube Data API 키가 필요합니다. API 키는 Marinara가 사용자를 대신해 서비스를 이용할 수 있게 해 주는 비밀 코드입니다. YouTube 로그인이나 Premium은 필요 없습니다.

  1. Music DJ 편집기에서 YouTube Connection(YouTube 연결)을 찾으세요.
  2. 앱의 링크로 Google Cloud Console을 열고 프로젝트를 만들거나 고르세요.
  3. YouTube Data API v3를 활성화하세요.
  4. Credentials, Create credentials, API key 순서로 이동하세요.
  5. 키를 YouTube Data API Key(YouTube Data API 키)에 붙여 넣으세요.
  6. Save Key(키 저장)를 클릭하세요. 그러면 버튼이 Update Key(키 업데이트)로 바뀌고 초록색 "API key configured" 배지가 나타납니다. Remove(제거)는 키를 삭제합니다.

키는 제한 없이 두거나, API 기준으로 YouTube Data API v3로만 제한하세요. HTTP 리퍼러 기준으로는 제한하지 마세요. 검색은 서버에서 실행되므로 리퍼러 제한을 걸면 검색이 막힙니다. 앱에는 무료 쿼터(하루 약 100회 검색)가 개인용 DJ에는 충분하다고 나와 있습니다. 이 수치는 앱 문구에서 가져온 것이므로 바뀔 수 있습니다. 키는 서버에 암호화되어 보관됩니다.

직접 가진 음악 파일 쓰기

Custom 모드는 Marinara를 실행하는 컴퓨터의 오디오 파일을 재생합니다. 지원하는 형식은 .mp3, .ogg, .wav, .flac, .m4a, .aac, .webm입니다.

Music DJ 편집기에서 Custom Music Library(사용자 지정 음악 라이브러리)를 찾으세요. 여기에는 Use Game Assets music folder(게임 에셋 음악 폴더 사용) 스위치 하나가 있습니다.

Roleplay와 Game 설정에는 같은 소스가 표시됩니다. 서버 기기의 폴더를 골랐다면 채팅의 Music DJ 설정에 그 경로와 Choose Folder(폴더 선택) 버튼이 표시됩니다.

Game Assets 밖의 폴더에서 재생하려면 서버의 로컬 접근 권한이 필요합니다. 로그인이나 관리자 시크릿 없이 다른 기기에서 쓰면 이 기능이 막힐 수 있습니다. 원격 접근: 로그인과 IP 허용 목록을 참고하세요.

음악 플레이어 사용하기

Music Player는 데스크톱에서는 상단 바의 배지로, 모바일에서는 끌어서 옮길 수 있는 위젯으로 표시됩니다. 표시하거나 숨기려면 Settings → General → App Behavior(설정 → 일반 → 앱 동작)를 열고 Music Player를 켜거나 끄세요. 기본값은 켜짐입니다. 켜져 있는데 Music DJ가 설치되지 않았다면 플레이어에 Download Music DJ Agent to configure(설정하려면 Music DJ 에이전트를 다운로드하세요)가 표시되고 Agent Organizer 버튼이 나타납니다.

새 프로필에서는 소스가 YouTube로 시작합니다. 플레이어의 원형 소스 전환 버튼(툴팁 "Switch to ... player"), 편집기의 Music Player 버튼, 채팅의 Music DJ 설정에서 바꿀 수 있습니다.

플레이어에는 트랙의 커버나 썸네일, 제목, 아티스트나 채널이 표시됩니다. 조작 버튼은 소스에 따라 다릅니다.

DJ Mari: AI 플레이리스트 제작

Spotify 미니 플레이어의 DJ 버튼("DJ Mari composes a playlist for you!")은 테마에 맞는 플레이리스트를 만듭니다. DJ Mari는 연결된 AI 모델에 요청해 페르소나, 가장 많이 쓴 캐릭터, 모든 채팅의 최근 내용을 바탕으로 플레이리스트를 만듭니다. 찾아낸 곡을 "DJ Mari"와 오늘 날짜를 이름으로 한 새 Spotify 플레이리스트에 담고 재생을 시작합니다.

두 가지가 필요합니다.

성공하면 "DJ Mari playlist is ready"와 함께 Open playlist(플레이리스트 열기) 버튼이 표시됩니다.

Game Mode의 Music DJ

Game Mode에는 Game Assets에서 가져오는 자체 배경 음악이 있습니다. 대신 Music DJ를 쓰려면 Game 설정에서 Music DJ 토글을 켜세요("Use the Music DJ for this game instead of local music assets"). 기본값은 꺼짐입니다. 켜면 Roleplay와 같은 Spotify, YouTube, Custom 선택지와 항목을 쓸 수 있습니다.

Spotify를 쓰면 장면이 끝날 때마다 서버가 고른 소스에서 실제 후보 곡의 짧은 목록을 만들고, AI가 그중 한 곡을 고릅니다. 이렇게 하면 AI가 곡을 지어내지 않습니다. Game Mode는 한 번에 한 곡을 반복 재생합니다. 현재 장면의 곡을 새로 고르려면 Game controls(게임 컨트롤)를 열고 Retry Music DJ(Music DJ 재시도)를 선택하세요. 게임 컨트롤을 참고하세요.

Conversation의 Music 명령어

Conversation에서는 Music DJ를 에이전트로 추가할 수 없습니다. 대신 캐릭터가 Music 명령어로 곡을 재생합니다.

  1. 채팅의 Commands(명령어) 섹션을 열고 상위 Commands 토글을 켜세요.
  2. Music을 켜세요("Let characters play songs through the active Music Player").

그러면 캐릭터가 Spotify용으로 곡 이름을 대거나 YouTube용으로 트랙을 설명할 때 Marinara가 현재 소스로 재생합니다. Music DJ를 어디에서도 켜지 않았어도 동작합니다. Spotify 연결이나 저장된 YouTube 키만 있으면 됩니다. Spotify가 연결되지 않았거나 재생 권한이 없으면 Spotify 곡 명령어는 아무 동작도 하지 않고 오류도 표시하지 않습니다.

문제 해결

관련 가이드