功能說明
알아두기
- 클라우드 드라이브 소스는 Primuse에 인증한 계정의 파일만 읽을 수 있습니다. 인증 정보는 기기의 키체인에 저장됩니다.
- 각 소스는 별도의 로그인 정보를 저장합니다. 취소하거나 인증에 실패해도 기존 연결은 변경되지 않습니다.
- 클라우드 드라이브 스캔은 먼저 파일 이름만 읽고, 노래 세부 정보는 나중에 백그라운드에서 일괄로 채웁니다(아래 ‘데이터 절약’ 참고).
시작 위치
설정 → 소스 관리(라이브러리 그룹) → +를 연 다음 클라우드 드라이브에서 드라이브를 선택하세요. Mac에서는 사이드바의 소스 섹션에서도 추가할 수 있습니다.
세 가지 로그인 방식
| 방식 | 드라이브 | 필요한 것 |
|---|---|---|
| 브라우저 인증 | Baidu Pan, Aliyun Drive, Google Drive, OneDrive, Dropbox, 123 Pan, GuangYa Pan, pCloud | 드라이브 계정. 일부 빌드에서는 직접 발급한 개발자 자격 증명도 필요합니다(아래 참고) |
| API 액세스 토큰 | Drime | Drime 웹 설정에서 만든 토큰 |
| 앱 비밀번호 | InfiniCLOUD | InfiniCLOUD 계정과 앱 비밀번호 |
115 Drive를 추가하면 ‘… 아직 사용할 수 없음’이 표시됩니다. Primuse가 … 오픈 플랫폼의 공식 액세스를 신청 중입니다. 승인되면 바로 로그인할 수 있습니다. 기대해 주세요. 이미 해당 플랫폼의 개발자 앱이 있다면 아래 자격 증명을 입력하여 지금 사용해 볼 수 있습니다.
브라우저 인증 단계
- 드라이브 유형을 선택하고 저장하면 연결 페이지가 열리고 먼저 ‘인증 상태 확인 중…’이 표시됩니다.
- 인증하여 연결이 표시되면:
- iPhone / iPad: 아래 버튼을 탭하면 브라우저에서 인증 페이지가 열립니다. 로그인 후 동의하면 Primuse가 파일에 접근할 수 있습니다.
- Mac: '인증하여 연결'을 탭하면 시스템 브라우저에서 인증 페이지가 열립니다. 로그인 후 동의하면 자동으로 Primuse로 돌아옵니다.
- 브라우저에서 드라이브 계정에 로그인하고 접근을 허용하세요. 기다리는 동안 Primuse에 ‘시스템 브라우저에서 인증 코드를 기다리는 중…’이 표시됩니다. Mac에서는 ‘인증 단계’이 나열됩니다. 인증이 완료되면 이 창은 자동으로 디렉터리 브라우저로 전환됩니다. 시스템 브라우저의 콜백 페이지를 닫지 마세요.
- 인증에 성공하면 폴더 탐색이 열립니다. 음악이 있는 폴더를 선택하고 스캔을 시작하세요.
같은 유형의 드라이브가 이미 기기에 로그인되어 있으면 로그인된 계정 사용과 다른 계정으로 로그인 두 가지 옵션이 표시됩니다.
개발자 자격 증명이 필요한 경우
연결 페이지에 ‘개발자 자격 증명이 필요합니다’이 표시되면 이 빌드에는 해당 드라이브의 기본 제공 자격 증명이 없으므로 드라이브의 오픈 플랫폼에서 직접 발급받아야 합니다. 페이지에는 네 단계가 표시됩니다.
- 플랫폼 안내(예: pan.baidu.com/union에서 개발자 앱을 등록하세요; alipan.com/developer에서 액세스를 신청하세요; console.cloud.google.com에서 OAuth 자격 증명을 만드세요; entra.microsoft.com에서 앱을 등록하세요; dropbox.com/developers/apps에서 앱을 만드세요; 123pan.cn/developer에서 개발자 앱을 신청하세요; app.guangyapan.com/pan/docs/open-api에서 개발자 앱을 신청하세요; docs.pcloud.com/my_apps에서 앱을 만들고 Implicit Grant를 허용하세요)
- 앱을 만들고 Client ID(및 Client Secret)를 받으세요
- Primuse로 돌아와 이 소스를 편집하고 자격 증명을 입력하세요(입력 항목: 클라이언트 ID / 앱 키, 클라이언트 보안 비밀 또는 클라이언트 보안 비밀(선택 사항))
- '연결'을 다시 탭하여 인증하세요
App Store 출시 버전에서 어떤 드라이브에 기본 제공 자격 증명이 있는지는 소스 코드로 알 수 없습니다(출시 빌드의 구성에 따라 다름). 연결 페이지에 실제로 표시되는 내용을 따르세요.
인증에 실패한 경우
실패 페이지의 제목은 ‘연결 실패’이며 아래에 구체적인 이유가 표시됩니다. 다시 인증하려면 인증 재시도을, 저장된 인증을 다시 확인하려면 다시 확인을 탭하세요. 주요 이유:
- ‘Client ID가 설정되지 않음’: 위의 설명대로 개발자 자격 증명을 입력하세요.
- ‘암호를 일시적으로 읽을 수 없습니다. 기기의 잠금을 해제한 후 다시 시도해 주세요.’: 기기 잠금을 해제한 다음 다시 확인을 탭하세요.
- ‘저장된 암호를 안전하게 읽을 수 없습니다. 다시 시도하거나 자격 증명을 업데이트해 주세요.’: 다시 인증하세요.
- ‘인증 토큰 저장 실패’: 인증을 다시 시도하고, 계속 실패하면 진단 정보를 수집하세요. 진단 정보를 수집해 개발자에게 보내기 문서를 참고하세요.
- pCloud에 ‘pCloud 인증이 더 이상 유효하지 않습니다. 다시 인증하세요’가 표시되는 경우: 다시 인증하세요.
- Guangya에 ‘이 빌드에는 GuangYa 연동 자격 증명(client ID, project ID, 서명 키)이 없습니다’가 표시되는 경우: 이 버전은 Guangya에 연결할 수 없으니 새 버전을 기다리세요.
Drime: API 액세스 토큰 사용
- Drime을 선택하세요. 연결 페이지에 ‘Drime 연결’이 표시됩니다. Drime 설정 → Developer에서 만든 API 액세스 토큰을 붙여넣으세요. Primuse가 검증한 후 드라이브를 엽니다.
- 토큰을 API 액세스 토큰에 붙여넣고 Drime 연결을 탭하세요.
- Drime 설정 → Developer에서 토큰을 만든 후 여기에 붙여넣으세요. 토큰은 키체인에 안전하게 저장됩니다.
권한 안내: All은 재생, 쓰기, 삭제를 지원하고 Read Only는 탐색과 재생을 지원합니다. Restricted는 파일 읽기가 필요하며 사이드카 쓰기와 삭제에는 파일 쓰기도 필요합니다. 소스를 편집할 때: 기존 Drime 토큰을 유지하려면 비워 두고, 교체하려면 새 토큰을 입력하세요.
‘현재 Drime 토큰은 파일을 읽을 수 없습니다.’ 또는 ‘현재 Drime 토큰은 읽기 전용이거나 파일 쓰기 및 삭제 권한이 없습니다.’가 표시되면 Drime에서 토큰 권한을 변경한 후 다시 연결하세요.
InfiniCLOUD: 앱 비밀번호 사용
InfiniCLOUD 사용자 이름과 앱 비밀번호를 입력하세요. InfiniCLOUD 마이 페이지에서 외부 앱 연결을 활성화한 다음 생성된 앱 비밀번호를 입력하세요. ‘이 버전에는 InfiniCLOUD 연결 키가 설정되어 있지 않습니다.’가 표시되면 이 버전은 InfiniCLOUD에 연결할 수 없습니다.
데이터 절약: Wi-Fi에서만 세부 정보 불러오기
설정 → 저장 공간(라이브러리 그룹) → 클라우드 세부 정보는 Wi-Fi에서만로 이동하세요.
클라우드 스캔은 먼저 파일 이름만 가져옵니다. 트랙 세부 정보(아티스트, 앨범, 커버, 길이)는 백그라운드에서 곡당 약 256KB씩 불러옵니다. 이 옵션을 켜면 셀룰러에서는 로딩이 일시 정지되고 Wi-Fi에 다시 연결되면 재개됩니다.
Apple TV에서 클라우드 드라이브에 로그인
Apple TV에는 브라우저가 없으므로 클라우드 드라이브는 QR 코드로 로그인합니다.
- 대부분의 드라이브: TV에 QR 코드가 표시되며 안내 문구는 예를 들어 다음과 같습니다. ‘iPhone 또는 iPad의 카메라로 스캔해 Primuse에서 …에 로그인하세요. 로그인 정보는 로컬 네트워크를 통해 이 Apple TV로 바로 전달됩니다.’ 휴대폰에 Primuse가 설치되어 있고 Apple TV와 같은 로컬 네트워크에 연결되어 있어야 합니다.
- 휴대폰에 ‘Apple TV에서 … 로그인’이 표시됩니다. 이 기기에서 로그인하면 인증 정보가 암호화되어 로컬 네트워크를 통해 Apple TV로 전달됩니다. 이 기기에는 소스가 추가되지 않으며, 인증 정보도 이 기기에 저장되지 않습니다. Apple TV에 표시된 확인 코드가 아래 코드와 같은지 확인하세요
- 완료되면: 완료되었습니다. 이제 Apple TV에서 스캔할 폴더를 선택하라는 안내가 표시됩니다.
- 휴대폰에 ‘현재 버전의 Primuse에서는 아직 휴대폰에서 Apple TV 대신 이 서비스에 로그인할 수 없습니다.’가 표시되면 이 드라이브는 아직 휴대폰으로 로그인할 수 없습니다.
주요 실패: ‘Apple TV가 로컬 네트워크에 연결되어 있지 않아 QR 코드를 표시할 수 없습니다.’, ‘Apple TV에 연결할 수 없습니다. 두 기기가 같은 로컬 네트워크에 있고 Apple TV에 QR 코드가 계속 표시되어 있는지 확인하세요.’, ‘Apple TV가 이 로그인을 받아들이지 않았습니다. QR 코드가 바뀌었을 수 있습니다. Apple TV에 표시된 코드를 다시 스캔하세요.’.
제한 사항
- 첫 스캔은 파일 이름만 읽습니다. 아티스트, 앨범, 아트워크, 재생 시간 등의 세부 정보는 나중에 일괄로 채워지며, 라이브러리가 크면 시간이 걸립니다. 클라우드 세부 정보는 Wi-Fi에서만이 켜져 있으면 셀룰러에서는 일시 중지됩니다.
- 드라이브 웹사이트에서 접근 권한을 취소했거나 인증이 만료되면 Primuse에서 다시 인증하세요.
- 재생, 캐시, 오프라인 다운로드 설정은 오프라인 다운로드, 오디오 캐시 및 저장 공간 관리 문서를 참고하세요.