Flutter三星应用内购买插件samsung_galaxy_in_app_purchase的使用

Flutter 三星应用内购买插件 samsung_galaxy_in_app_purchase 的使用

概述

一个帮助你在 Flutter 应用程序中集成三星 Galaxy 应用内购买（IAP）SDK 的插件，以便在三星 Galaxy 设备上实现无缝的应用内购买功能。

部分屏幕截图

使用步骤

1. 准备好你的应用程序：确保你的应用接近部署状态（模拟 IAP 流程）
2. 拥有三星设备
3. 登录三星账户：确保设备已登录到三星账户（设备设置）
4. 注册开发者账号：
   • 在 Galaxy Store 创建一个账号，并填写必要信息
   • 上传 APK 文件
   • 填写 IAP 产品信息（例如：你的商品 ID 应该与你的应用包名一致，如 com.app.mobile.dev_item_xyz）
5. 注册测试用户：在 Galaxy Store Admin 注册测试用户
6. 在 Flutter 应用中集成此插件并进行配置：
   • 确保使用的是第 5 步中添加的测试账户，并且 IAP 商品具有相同的包名

工作原理

我们使用了 Samsung In-App Purchase SDK v6.1，因此在 Flutter 端可以使用通道来执行其 IAP 功能。

特性

• 显示来自 Galaxy 商店的可售应用内产品。
• 加载用户拥有的应用内产品。
• 展示 Galaxy UI 进行购买操作。
• 可支持的类型包括消耗型、非消耗型和订阅型商品，但当前版本仅包含消耗型商品。

步骤 1: 添加依赖

在 pubspec.yaml 中添加以下依赖：

dependencies:
  samsung_galaxy_in_app_purchase: any

步骤 2: 配置 build.gradle

在项目的根目录下的 build.gradle 文件中添加以下配置：

allprojects {
    repositories {
        ...
        flatDir {
            dirs 'libs'
            dirs project(':samsung_galaxy_in_app_purchase').file('libs')
        }
    }
}

步骤 3: 在 Flutter 应用中使用

创建一个 GalaxyIap 实例，并调用其提供的函数。

import 'package:flutter/material.dart';
import 'package:samsung_galaxy_in_app_purchase/samsung_galaxy_in_app_purchase.dart';

void main() {
  runApp(
    const MaterialApp(
      home: Scaffold(
        body: GalaxyIapExample(),
      ),
    ),
  );
}

class GalaxyIapExample extends StatefulWidget {
  [@override](/user/override)
  _GalaxyIapExampleState createState() => _GalaxyIapExampleState();
}

class _GalaxyIapExampleState extends State<GalaxyIapExample> {
  final _galaxyIapPlugin = GalaxyIap();

  // 获取平台版本
  Future<void> getPlatformVersion() async {
    String? version = await _galaxyIapPlugin.getPlatformVersion();
    if (mounted) {
      showDialog(
        context: context,
        builder: (BuildContext context) {
          return Dialog(
            child: Column(
              mainAxisSize: MainAxisSize.min,
              children: [
                Padding(
                  padding: const EdgeInsets.all(16.0),
                  child: Text(version ?? 'error'),
                ),
                ElevatedButton(
                  onPressed: () {
                    Navigator.of(context).pop();
                  },
                  child: const Text('Close'),
                ),
              ],
            ),
          );
        },
      );
    }
  }

  // 获取商品详情
  Future<void> getProductDetails(String itemText) async {
    final listResult = await _galaxyIapPlugin.getProductDetails(itemText.trim());
    if (mounted) {
      showDialog(
        context: context,
        builder: (BuildContext context) {
          return ProductDetailDialog(item: listResult[0]);
        },
      );
    }
  }

  // 购买商品
  Future<void> purchaseItem(String itemText) async {
    final purchase = await _galaxyIapPlugin.purchaseItem(
      itemText.trim(),
      'your_pass_through_param',
    );
    if (mounted && purchase != null) {
      setState(() {
        lastPurchaseId = purchase.mPurchaseId;
      });
      showDialog(
        context: context,
        builder: (BuildContext context) {
          return PurchaseDetailDialog(purchase: purchase);
        },
      );
    }
  }

  // 消费已购商品
  Future<void> consumePurchasedItem(String lastPurchaseId) async {
    if (lastPurchaseId != null) {
      final consumes = await _galaxyIapPlugin.consumePurchasedItem(lastPurchaseId);
      if (mounted) {
        showDialog(
          context: context,
          builder: (BuildContext context) {
            return ConsumesListDialog(consumes: consumes);
          },
        );
      }
    }
  }

  // 获取用户已购商品
  Future<void> getUserOwnedItems(String item) async {
    final listResult = await _galaxyIapPlugin.getUserOwnedItems(item);
    if (mounted) {
      showDialog(
        context: context,
        builder: (BuildContext context) {
          return ProductsListDialog(products: listResult);
        },
      );
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          ElevatedButton(
            onPressed: getPlatformVersion,
            child: Text('Get Platform Version'),
          ),
          ElevatedButton(
            onPressed: () => getProductDetails('test_item'),
            child: Text('Get Product Details'),
          ),
          ElevatedButton(
            onPressed: () => purchaseItem('test_item'),
            child: Text('Purchase Item'),
          ),
          ElevatedButton(
            onPressed: () => consumePurchasedItem('test_purchase_id'),
            child: Text('Consume Purchased Item'),
          ),
          ElevatedButton(
            onPressed: () => getUserOwnedItems('test_item'),
            child: Text('Get User Owned Items'),
          ),
        ],
      ),
    );
  }
}