Flutter功能扩展插件aiuta_flutter的使用

Aiuta Virtual Try On SDK 是一个用于Flutter应用的虚拟试衣解决方案，特别适合服装和时尚业务。本文将详细介绍如何在Flutter项目中集成和使用该插件。

权限配置

iOS

在iOS项目的Info.plist文件中添加以下权限：

<key>NSCameraUsageDescription</key>
<string>我们需要访问您的相机以便为您提供虚拟试衣体验。</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>我们需要保存生成的图像到您的相册。</string>

Android

无需特殊配置，插件应可直接使用。

可用性

iOS

支持iOS 12.0及以上版本编译，但SDK需要iOS 13.0或更高版本才能正常工作。请在提供虚拟试衣功能前检查SDK的可用性：

if (await aiuta.isAvailable) {
  // 提供虚拟试衣功能
}

Android

需要minSdkVersion = 23或更高。

配置

参考配置文档了解详细配置选项。

虚拟试衣功能

调用startTryonFlow方法以提供虚拟试衣功能：

_aiuta.startTryonFlow(
  product: AiutaProduct(
    skuId: Env.SKU_ID,
    catalogName: Env.SKU_CATALOG_NAME,
    title: "YOUR title",
    imageUrls: [
      "YOUR image 1",
      "YOUR image 2",
    ],
    brand: "YOUR brand",
    inWishlist: true,
  ),
);

产品信息

AiutaProduct表示在Aiuta平台上的SKU信息。

试穿历史

调用startHistoryFlow方法以显示用户的试穿历史：

_aiuta.startHistoryFlow();

示例代码

以下是一个完整的示例代码，展示如何在Flutter应用中集成并使用aiuta_flutter插件：

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _aiuta = Aiuta(
    configuration: AiutaConfiguration(
      mode: AiutaMode.fullScreen,
      authentication: ApiKeyAuthentication(
        subscriptionId: 'your_subscription_id',
        apiKey: 'your_api_key',
      ),
      toggles: AiutaToggles(
        isHistoryAvailable: true,
        isWishlistAvailable: true,
        isPreOnboardingAvailable: false,
        isShareAvailable: false,
        isBackgroundExecutionAllowed: true,
      ),
      language: StandardLanguage(
        language: DefaultAiutaLanguages.english,
        brand: "YOUR Brand",
        termsOfServiceUrl: "https://brand.com/tos",
        privacyPolicyUrl: "https://brand.com/pp",
        onboardingPageConsentSupplementaryPoints: [
          'Optional consent point',
        ],
      ),
      theme: AiutaTheme(
        colors: AiutaColors(
          primary: "#FF000000",
          secondary: "#FF9F9F9F",
          tertiary: "#FFEEEEEE",
        ),
      ),
    ),
  );

  bool _isAiutaAvailable = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    Aiuta.isAvailable.then((isAvailable) {
      setState(() {
        _isAiutaAvailable = isAvailable;
      });
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Aiuta SDK example app'),
        ),
        body: Center(
          child: _isAiutaAvailable
              ? Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    TextButton(
                      onPressed: () {
                        _aiuta.startTryonFlow(
                          product: AiutaProduct(
                            skuId: 'your_sku_id',
                            catalogName: 'your_catalog_name',
                            title: "YOUR title",
                            imageUrls: [
                              "YOUR image 1",
                              "YOUR image 2",
                            ],
                            brand: "YOUR brand",
                            inWishlist: true,
                          ),
                        );
                      },
                      child: const Text('Start Aiuta'),
                    ),
                    TextButton(
                      onPressed: () {
                        _aiuta.startHistoryFlow();
                      },
                      child: const Text('Show history'),
                    ),
                  ],
                )
              : const Text('Aiuta is not available'),
        ),
      ),
    );
  }
}