유료 기능 잠그기

Paywall.gate로 앱 전체를 팔거나, Paywall.start와 기능별 확인 하나로 일부 기능을 파세요. 이 페이지에는 라이브러리의 모든 공개 호출과 상수, 체험의 작동 방식이 있습니다.

앱 전체 또는 일부 기능

둘 다 getInitialView()에서 반환하는 것과 같은 배열을 받습니다. 뷰, 또는 뷰와 그 델리게이트입니다.

기능 잠그기

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 속성.
• 내 키에는 다른 이름을 쓰세요.