鎖定付費功能

用 Paywall.gate 販售整個應用程式，或用 Paywall.start 販售部分功能，並為每個功能加一個檢查。本頁列出程式庫中的所有公開呼叫和常數，以及試用如何運作。

整個應用程式或部分功能

兩者都接受與 getInitialView() 回傳相同的陣列：一個 view，或一個 view 及其 delegate。

鎖定功能

使用 start 時，在每個付費功能的入口處檢查：按鈕、選單項目、頁面。

function onHistory() as Void {
    if (Paywall.unlocked()) {
        showHistory();
    } else {
        Paywall.open();
    }
}

• 一次解鎖，全部開啟。一次購買即可開啟應用程式中的所有付費功能。每個應用程式只有一個價格。
• 在概覽中，只能呼叫 active()、unlocked() 和 trialLeft()。購買畫面僅限應用程式使用。
• 只應向買家顯示、試用期間不顯示的感謝小細節，請先檢查 Paywall.active()。

參考

除非表格另有說明，這裡的所有內容都位於 module Paywall（Pay.mc 和你使用的 PayScope.mc）。

你呼叫的方法

由程式庫自行呼叫

這些由程式庫自行呼叫。請勿從你的程式碼呼叫。

常數

模組變數

購買畫面本身的狀態。需要時可以讀取，但絕不要設定。

類別

PaywallConfig

錶面與資料欄位

錶面和資料欄位使用 lib/watch/face，其 module Paywall 有自己的呼叫。active()、unlocked() 和 trialLeft() 的運作方式同上。

完整設定請參閱錶面與資料欄位。

試用

• 在 PaywallConfig 中設定 TRIAL_DAYS，與控制台中的免費試用一致。不提供試用就省略：這樣永遠不會顯示「試用結束」。
• 試用從第一次啟動開始。結束前 Paywall.unlocked() 都為 true。
• 重新安裝不會重新開始試用。我們的伺服器從第一次看到該手錶時開始計算試用期，並在第一次回應時以伺服器的計數取代手錶的計數。
• 把時鐘調回也無法延長。伺服器傳送的是剩餘時間而非日期，且手錶計算的天數絕不超過 TRIAL_DAYS。
• 購買畫面的標題依序顯示「剩 7 天」、「最後一天」、「試用結束」。

由應用程式計算的試用期

若要依使用次數而非天數計算試用，請省略 TRIAL_DAYS，在儲存空間中保留自己的計數器（「刪除資料」後也要保留），並檢查 active()：

// 20 free sessions, then Premium
if (Paywall.active() || sessionsUsed < 20) {
    startSession();
} else {
    Paywall.open();
}

程式庫儲存的內容

• 應用程式："pa"（回應）、"pp"（上次確認「已付款」的時間）、"ts"（試用結束時間）和 "te"（已顯示「試用結束」）。
• 錶面和資料欄位："pa"、"pp"、"ts" 和 "pg"，以及用於設定連結的 unlock 屬性。
• 你自己的鍵請使用其他名稱。