支援

安裝與使用幫助

本頁提供 Android APK 的下載、安裝與更新步驟,以及 USB DAC 輸出和藍牙播放的常見問題。其他問題請以中文或英文電子郵件聯絡我們。

郵件中請盡量提供以下資訊

  • 應用程式版本(設定 → 關於)
  • 手機型號和 Android 版本
  • 所用的 DAC 或耳機
  • 檔案格式,例如 FLAC 24-bit / 96 kHz
  • 如為輸出相關問題,請附上鏈路頁截圖

安裝 Vesqen

  1. 01

    確認手機執行 Android 9.0 以上版本,可在「設定 → 關於手機」中查看。

  2. 02

    點選下方的「下載 APK」。檔案來自 GitHub Releases,檔名為 Vesqen-1.2.0.apk。

  3. 03

    在瀏覽器的下載清單或檔案管理器中開啟該檔案。首次安裝時,Android 會請你允許該應用程式安裝其他應用程式:點選「設定」,開啟「允許來自此來源的應用程式」,然後返回。

  4. 04

    點選「安裝」。部分手機隨後會顯示其自帶的安全檢測,因為該應用程式並非從其應用程式商店下載。只要檔案來自本站或 GitHub Releases,即可繼續安裝。如需自行核對檔案,請參閱下方的「如何確認下載的 APK 為官方版本?」。

  5. 05

    開啟 Vesqen,並允許其讀取音樂。允許通知後,通知欄中會顯示播放控制。

下載 APK版本說明和 SHA-256

後續更新方法請參閱下方的「如何更新?」。請勿先解除安裝,否則播放清單、收藏和設定會被刪除(音樂檔案本身不受影響)。Android 8.0 和 8.1 無法安裝 1.0,可繼續使用 1.0.0-beta.3。

常見問題

如何更新?

開啟「設定 → 更新」。Vesqen 會在每次開啟時檢查新版本,每天最多一次;你也可以點選「檢查更新」。只有在你點選「下載」後才會下載新版本,下載完成後會核對 SHA-256 和簽署,再點選「安裝」,由 Android 請你確認。首次安裝時,系統會要求允許 Vesqen 安裝應用程式:允許後返回,再點選一次「安裝」。所有版本均使用同一金鑰簽署,因此也可以直接安裝新版本的 APK 覆蓋舊版本,播放清單、收藏和設定都會保留。1.0.0-beta.1 不具備檢查更新功能,需以此方式手動升級一次。

如何確認下載的 APK 為官方版本?

每個版本的發布頁面均列有 APK 的 SHA-256,可與你所下載檔案計算出的 SHA-256 進行比對。也可以使用 apksigner verify --print-certs 查看簽署憑證,其 SHA-256 應為 74:3E:96:FC:B7:1D:C5:81:88:49:68:19:A0:01:A2:7C:D8:8D:90:91:62:C5:AE:92:9C:87:BF:A2:9A:B8:62:93。使用其他金鑰簽署的安裝包,Android 不允許其覆蓋安裝 Vesqen。

安裝時出現「应用备案状态未知」或「无法识别应用核准(备案)情况」,是否正常?

正常。在中國大陸銷售的手機上安裝未辦理 ICP 備案的應用程式時,均會顯示此類提示,我們在華為、榮耀、vivo 和 iQOO 手機上均遇到過。從 GitHub 下載的應用程式和境外應用程式大多會出現這一提示。Vesqen 目前未在中國大陸應用程式商店上架,也未辦理備案,因此會顯示該提示。它僅表示未查詢到備案資訊。如果 APK 是從 Vesqen 官網或 GitHub Releases 下載的,或已按上一條核對過 SHA-256 和簽署憑證,即可點選「繼續安裝」。vivo 和 iQOO 手機需先勾選「已了解應用程式的風險檢測結果」。

為什麼 vivo 或 iQOO 手機的鎖定畫面上沒有 Vesqen 的播放控制項?

vivo 和 iQOO 手機為每個應用程式單獨設定「鎖定畫面通知」,Vesqen 的這一項可能處於關閉狀態。請開啟系統的通知設定,選擇 Vesqen,並開啟「鎖定畫面通知」。開啟後,鎖定畫面上將顯示正在播放的歌曲,以及上一首、播放 / 暫停和下一首按鈕。

為什麼顯示 SYSTEM MIXED?

SYSTEM MIXED 表示音訊經由 Android 的一般播放路徑輸出,系統可能將其與其他聲音混合、進行重取樣或添加音效。大多數應用程式均以這種方式播放,手機揚聲器、有線耳機和藍牙均屬此類。只有在 Android 提供的證據充分時,Vesqen 才會顯示 BIT-PERFECT 狀態。

為什麼無法開啟嚴格 USB 輸出?

嚴格 USB 輸出需要同時滿足三個條件:Android 14 以上;手機系統開放了 Android 的 bit-perfect 輸出通路;USB DAC 能為目前檔案提供匹配的 bit-perfect mixer 組態。許多手機即使執行 Android 14 以上版本,也未開放這一通路;Android 13 以下版本則沒有這一官方介面。後續版本將嘗試透過 自行開發的 USB 輸出支援這些手機,目前尚無法保證。播放過程中只要有任一條件不滿足,Vesqen 就會停止播放並說明原因,不會自動切換回系統輸出。

藍牙能做到 bit-perfect 嗎?

不能。手機會先使用 SBC、AAC、LDAC 等藍牙編碼對音訊重新編碼,再發送至耳機,因此 Vesqen 始終將藍牙標記為 SYSTEM MIXED。

是否需要聯網?

不需要。播放和音樂庫從不聯網。在聯網狀態下,Vesqen 每天最多發送一次使用統計,從 GitHub 安裝的版本還會檢查更新,這兩項均可在設定中關閉。

BIT-PERFECT ACTIVE 和 VERIFIED 有甚麼區別?

ACTIVE 表示 Android 報告的 AudioTrack、mixer 設定和輸出路由均與目前檔案一致,這是來自 Android 端的證據。VERIFIED 需要一份經外部裝置測量並簽署的驗證記錄,應用程式還會核對記錄中的應用程式、手機、DAC 和格式是否與你目前的組態完全相同。目前尚無任何組合獲得 VERIFIED 記錄。

Google Play 版

Vesqen 正在 Google Play 上進行封閉測試,獲得 Google 批准後將上架,版本與 GitHub 上的相同。Play 版通過 Google Play 更新,不使用應用程式內的更新檢查。

Vesqen 1.x 免費提供。你可透過 Buy Me a Coffee 支持開發,款項將用於自行開發的 USB 輸出引擎,以及改善更多手機與 DAC 的播放相容性及準確性。支持開發由你自行決定,不會解鎖應用程式功能。

在 Buy Me a Coffee 上支持開發

已知問題

目前的限制、正在修復的問題以及 2.0 的計畫,均匯總在同一頁面中。如有 GitHub 帳號,也可以在 GitHub 上報告問題。

已知問題與計畫