> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bgms.live/llms.txt
> Use this file to discover all available pages before exploring further.

# 자주 묻는 질문

> BGMS 사용 시 자주 묻는 질문과 답변

# 자주 묻는 질문 (FAQ)

BGMS 사용 중 자주 묻는 질문들을 모았습니다.

## 검색 관련

### 검색이 안 돼요

검색 기능을 사용하려면 Google Access Token 설정이 필요합니다.

👉 [검색 기능 설정하기](https://docs.bgms.live/ko/search.md)

### 검색 없이 음악을 추가할 수 있나요?

현재는 Google Access Token 없이는 음악을 추가할 수 없습니다. YouTube URL 직접 입력 기능은 개발 중입니다.

👉 [검색 기능 설정하기](https://docs.bgms.live/ko/search.md)

## 초대 관련

### 초대 메일이 안 와요

다음을 확인해보세요:

* Gmail 계정으로 초대했는지 확인
* 스팸 메일함 확인
* Google Workspace 계정인 경우 관리자 설정 확인

### Gmail이 아닌 다른 이메일로 초대할 수 있나요?

아니요, BGMS는 Gmail과 Google Workspace 계정만 지원합니다.

## 채널 관련

### 채널을 몇 개까지 만들 수 있나요?

최대 **3개**까지 채널을 만들 수 있습니다.

### 채널을 삭제하려면 어떻게 하나요?

채널 설정에서 삭제 옵션을 찾을 수 있습니다.

### 고스트 채널이란 무엇인가요?

고스트 채널이란 오너가 채널에서 탈퇴하여 **채널이 동결된 상태**를 말해요.

고스트 채널이 되면 초대 등의 멤버 관리, 플레이리스트 추가/삭제 등의 기능이 제한되지만, 기존 멤버들은 플레이어를 통해 컨텐츠를 그대로 즐길 수 있어요.

> [!WARNING]
>
> 한번 고스트 채널로 변경되면 다시 복구할 수 없어요.

### 채널에서 멤버들이 모두 나가면 어떻게 되나요?

기존 멤버들이 모두 채널에서 나갔을 경우에는 채널이 사라지게 되니 주의해주세요!

## 재생 관련

### 광고가 정말 안 나오나요?

네! BGMS를 통해 재생되는 YouTube 음악은 영상 중간 광고가 재생되지 않습니다. (화면 하단 배너 광고는 나타날 수 있습니다)

### 여러 사람이 동시에 음악을 추가하면 어떻게 되나요?

추가된 순서대로 재생 목록에 쌓입니다. 주크박스처럼 모두가 함께 음악을 즐길 수 있습니다!

## 문제 해결

### 음악이 재생되지 않아요

**다음을 확인해보세요:**

1. **YouTube 접근 권한 확인**
   * Google Access Token이 정상적으로 설정되었는지 확인
   * 토큰의 유효 기간이 만료되지 않았는지 확인
   * [검색 기능 설정하기](https://docs.bgms.live/ko/search.md)를 참고하여 재설정

2. **인터넷 연결 확인**
   * Wi-Fi 또는 모바일 데이터 연결 상태 확인
   * 연결이 불안정하면 다시 연결 시도

3. **브라우저 캐시 초기화**
   * 브라우저의 캐시와 쿠키 삭제
   * 페이지 새로고침

4. **다른 기기에서 시도**
   * 다른 기기에서 같은 계정으로 접속하여 문제 재현 확인

**위 방법으로 해결되지 않으면 [cs@bgms.live](mailto:cs@bgms.live)로 문의해주세요.**

### "이 동영상은 재생할 수 없습니다" 오류

**이 오류가 발생하는 이유:**

* YouTube가 해당 음악의 재생을 제한함 (지역 제한, 라이선스 문제 등)
* 음악이 더 이상 YouTube에서 삭제됨
* YouTube 계정의 재생 제한 설정

**해결 방법:**

1. **다른 버전의 음악 찾기**
   * 같은 곡의 다른 업로더 버전 검색 시도
   * 음악가의 공식 채널에서 찾기

2. **다시 로그인하기**
   * Google Access Token 재설정
   * 계정 다시 로그인

3. **VPN 사용 확인**
   * VPN을 사용 중이라면 비활성화 후 시도
   * 지역 제한이 원인일 수 있음

**특정 음악만 계속 오류가 발생하면, 다른 음악을 재생해보세요.**

### 초대 메일이 안 와요

**확인할 사항:**

1. **스팸 메일함 확인**
   * Gmail의 스팸 메일함에 들어가 있지 않은지 확인
   * 받은편지함의 기타 탭 확인

2. **이메일 필터 확인**
   * Gmail 설정 > 필터 및 차단된 주소에서 [cs@bgms.live](mailto:cs@bgms.live) 또는 관련 도메인 확인
   * 필터가 있으면 삭제

3. **Google Workspace 관리자 설정**
   * 회사 Google Workspace 계정인 경우, 관리자에게 이메일 수신 제한 여부 확인
   * 관리자가 외부 이메일 수신을 제한했을 수 있음

4. **초대 재요청**
   * 채널 오너가 초대 메일을 다시 보내도록 요청
   * 몇 분 기다린 후 다시 확인

**여전히 메일이 오지 않으면 [cs@bgms.live](mailto:cs@bgms.live)로 연락해주세요.**

### 여러 명이 동시에 제어할 때 꼬여요

**이것은 정상 동작입니다!**

BGMS는 주크박스 방식으로 설계되었습니다:

* **동시 음악 추가**: 여러 명이 동시에 음악을 추가하면 추가된 순서대로 재생 목록에 쌓임
* **순차 재생**: 한 곡이 끝나면 다음 곡이 자동으로 재생됨
* **공정한 시스템**: 모두가 평등하게 음악을 즐길 수 있음

**예상되는 상황:**

1. A가 곡1을 추가 (재생 중)
2. B가 곡2를 추가 (대기 중)
3. C가 곡3을 추가 (대기 중)
4. 곡1 끝나면 → 곡2 재생 → 곡3 재생

**이것이 의도된 설계이므로, "제어가 꼬인다"고 생각되면 다른 사용자의 음악 추가를 확인해보세요.**

### 채널 권한 관련

**오너 (Owner) 권한:**

* 채널 설정 수정
* 멤버 초대 및 제거
* 플레이리스트 추가 및 삭제
* 채널 삭제 가능

**멤버 (Member) 권한:**

* 음악 검색 및 추가
* 현재 재생 중인 음악 확인
* 플레이리스트 보기
* 멤버 관리 및 설정 변경 불가능

**권한 문제가 발생했나요?**

1. **권한 확인하기**
   * 채널에서 자신의 역할 확인 (오너인지 멤버인지)
   * 필요한 권한을 가진 오너에게 요청

2. **오너가 없는 경우 (고스트 채널)**
   * 고스트 채널은 기존 기능이 대부분 제한됨
   * [고스트 채널 정보](https://docs.bgms.live/ko/faq.md#고스트-채널이란-무엇인가요)를 참고해주세요.

**권한 변경이 필요하면 채널 오너에게 문의하세요.**

## 기술 지원

### 더 궁금한 점이 있어요

[cs@bgms.live](mailto:cs@bgms.live)로 문의해주세요.

## 기능 제안

### 새로운 기능을 제안하고 싶어요

기능 제안도 [cs@bgms.live](mailto:cs@bgms.live)로 보내주세요!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.