benxu.AppPlatform.Billing.RevenueCat 3.2.7

benxu.AppPlatform.Billing.RevenueCat

RevenueCat 訂閱服務整合套件，支援 Android / iOS 真實 SDK 與模擬測試模式。

功能

• ✅ 真實 RevenueCat SDK 整合（Android / iOS）
• ✅ 模擬模式（快速 UI 測試）
• ✅ Firestore 訂閱狀態同步
• ✅ Options Pattern 設定

安裝

dotnet add package benxu.AppPlatform.Billing.RevenueCat

快速開始

1. 設定 API Key

// MauiProgram.cs
builder.Services.AddRevenueCat(options =>
{
 // 真實 SDK 模式
 options.AppleApiKey = "appl_xxxxxxxxxx"; // iOS
 options.GoogleApiKey = "goog_xxxxxxxxxx"; // Android
 
 // 或使用 Test Store（開發測試）
 // options.TestStoreApiKey = "test_xxxxxxxxxx";
 
 // 權限設定
 options.PremiumEntitlementId = "premium";
 
 // Firestore 同步
 options.SyncToFirestore = true;
 options.FirestoreCollection = "subscriptions";
 
 // 若未訂閱或訂閱失效，改刪除文件而非寫入 status = none
 options.DeleteInactiveStatusDocument = true;
});

2. 初始化服務

// App.xaml.cs 或首次載入時
var subscription = serviceProvider.GetRequiredService<ISubscriptionService>();
await subscription.InitializeAsync(userId); // userId 可為 Firebase UID

3. 檢查訂閱狀態

@inject ISubscriptionService Subscription

@if (Subscription.IsSubscribed)
{
 <PremiumContent />
}
else
{
 <Paywall />
}

4. 購買訂閱

var result = await Subscription.PurchaseAsync("premium_monthly");
if (result.IsSuccess)
{
 // 購買成功
}
else if (result.ErrorType == PurchaseErrorType.UserCancelled)
{
 // 用戶取消
}

模擬模式

開發階段可啟用模擬模式，無需設定 RevenueCat：

builder.Services.AddRevenueCat(options =>
{
 options.SimulatorMode = true;
 
 options.Simulator.IsSubscribed = false; // 初始狀態
 options.Simulator.Products = new()
 {
 new() { Id = "premium_monthly", Title = "月訂閱", PriceString = "NT$ 150" },
 new() { Id = "premium_yearly", Title = "年訂閱", PriceString = "NT$ 1,490" }
 };
});

本地端測試

請參考 的第 8 章「本地端測試指南」。

依賴套件

相關文件