Overview
先了解
- 雲端硬碟來源只能讀取你授權給 Primuse 的帳號裡的檔案。授權資訊儲存在裝置的鑰匙圈中。
- 每個連線來源會獨立儲存登入憑證；取消或授權失敗不會變更現有連線。
- 掃描雲端硬碟時先只讀取檔名，歌曲詳情在背景分批補全（見下文「節省行動數據」）。
入口
設定 › 音樂來源管理（「資料庫」分組）› +，在「雲端硬碟」中選擇雲端硬碟類型。Mac 上也可以在側邊欄的「音樂來源」中新增。
三種登入方式
| 方式 | 適用雲端硬碟 | 你需要準備 |
|---|---|---|
| 瀏覽器授權 | 百度網盤、阿里雲盤、Google Drive、OneDrive、Dropbox、123 雲盤、光鴨雲盤、pCloud | 雲端硬碟帳號；部分版本還需要你自己的開發者憑證（見下文） |
| API 存取權杖 | Drime | 在 Drime 網頁設定中建立的權杖 |
| 應用密碼 | InfiniCLOUD | InfiniCLOUD 帳號和應用密碼 |
115 網盤 在新增後會顯示「… 暫未開放」：Primuse 正在向 … 開放平台申請官方接入資格，審核通過後即可直接登入使用，敬請期待。若你已自有該平台的開發者應用程式，也可依下方步驟填入憑證先行試用。
瀏覽器授權的步驟
- 選擇雲端硬碟類型並儲存後，進入連線頁面。頁面先顯示「正在檢查授權狀態…」。
- 如果顯示「授權連線」：
- iPhone / iPad：點按下方按鈕，將在瀏覽器中開啟授權頁面。 登入並同意授權後，Primuse 即可存取您的檔案。
- Mac：點按「授權連線」，將在系統瀏覽器中開啟授權頁。 登入並同意授權後會自動返回 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 Key」和「用戶端密鑰」或「用戶端密鑰（選填）」）
- 再次點按「連線」即可授權
哪些雲端硬碟在正式版中內建了憑證，原始碼無法確定（取決於發布建置的設定）。以連線頁實際顯示為準。
授權失敗
失敗頁標題為「連線失敗」，下方是具體原因。可以點「重試授權」重新走一遍授權，或點「重新檢查」重新檢查已儲存的授權。常見原因：
- 「未設定 Client ID」：按上一節填寫開發者憑證。
- 「暫時無法讀取密碼，請解鎖裝置後重試。」：解鎖裝置後點「重新檢查」。
- 「無法安全讀取已儲存的密碼，請重試或更新憑證。」：重新授權。
- 「授權權杖儲存失敗」：重試授權；仍失敗時收集診斷資訊，見 收集並傳送診斷資訊給作者。
- pCloud 顯示「pCloud 授權已失效，請重新授權」：重新授權。
- 光鴨雲盤顯示「此版本未設定光鴨開放平台接入憑證(client_id / project_id / 簽章密鑰)」：目前版本無法連線光鴨雲盤，需要等待新版本。
Drime：使用 API 存取權杖
- 選擇 Drime，連線頁顯示「連線 Drime」：貼上在 Drime 設定 → Developer 中建立的 API 存取權杖。Primuse 驗證成功後會開啟雲端硬碟目錄。
- 在「API 存取權杖」中貼上權杖，點「連線 Drime」。
- 請在 Drime 設定 → Developer 中建立權杖並貼到這裡。權杖會安全存入鑰匙圈。
權限說明：全部權限可播放、寫入和刪除；Read Only 可瀏覽和播放；Restricted 至少需要「檔案：讀取」，寫入封面／歌詞及刪除還需要「檔案：寫入」。 編輯來源時，留空會保留現有 Drime 權杖；輸入新權杖則會取代。
如果提示「目前 Drime 權杖無法讀取檔案。」或「目前 Drime 權杖為唯讀，或沒有寫入及刪除檔案的權限。」，到 Drime 調整權杖權限後重新連線。
InfiniCLOUD：使用應用密碼
填寫 InfiniCLOUD 使用者名稱和應用密碼。請在 InfiniCLOUD「我的頁面」啟用外部應用程式連線，並填入產生的應用程式密碼。 如果提示「此版本尚未設定 InfiniCLOUD 存取金鑰。」，說明目前版本無法連線 InfiniCLOUD。
節省行動數據：僅在 Wi-Fi 下載入詳情
入口：設定 › 儲存空間管理（「資料庫」分組）›「僅在 Wi-Fi 下載入雲端硬碟詳情」。
掃描雲端硬碟時只讀取檔名，詳情（歌手/專輯/封面/時長）會在背景分批載入。一首歌大約消耗 256KB 流量。開啟此項後，遇到行動網路會自動暫停，連上 Wi-Fi 自動繼續。
在 Apple TV 上登入網盤
Apple TV 沒有瀏覽器，雲端硬碟改用掃描 QR 碼登入：
- 多數雲端硬碟：電視上顯示 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 上的 QR 碼。」。
限制
- 首次掃描只讀取檔名，歌手、專輯、封面、時長等詳情在背景分批補全，資料庫很大時需要一段時間；開啟「僅在 Wi-Fi 下載入雲端硬碟詳情」後，行動網路下會暫停補全。
- 在雲端硬碟網頁版撤銷授權或授權過期後，需要在 Primuse 中重新授權。
- 播放、快取和離線下載的設定見 離線下載、音訊快取與儲存空間管理。