Flutter插件fw_ava_flutter_sdk的使用

Get Started（开始使用）

1. Prerequisites（前置条件）

// flutter
Flutter SDK ">=3.0.0"
Dart SDK ">=2.17.0 <4.0.0"

// iOS
iOS 14 或更高版本。

// Android
minSdkVersion 23 或更高版本。

2. Microphone Permission Configuration（麦克风权限配置）

为了启用与Ava的音频交互，需要配置麦克风权限：

iOS

• 在你的 info.plist 文件中添加 <code>NSMicrophoneUsageDescription</code>。

Android

• 无需额外配置。

3. Initialize the SDK（初始化SDK）

使用你的 avaId 初始化SDK：

FwAvaFlutterSdkInitializer.init(avaId: "yourAvaID");

注意：在使用 <code>AvaCard</code> 或 <code>AvaFloatingButton</code> 之前，必须先初始化SDK。无效的 <code>avaId</code> 将抛出 <code>IllegalArgumentAvaException</code>，而未初始化SDK就尝试使用这些组件会导致 <code>NotInitializedAvaException</code>。

4. Configure Localization（配置本地化）

为你的应用添加本地化支持：

MaterialApp(
  localizationsDelegates: const [
    GlobalMaterialLocalizations.delegate, // 添加Material本地化代理
    AvaLocalizations.delegate, // 添加Ava本地化代理
  ],
  supportedLocales: [
    ...AvaLocalizations.supportedLocales, // 添加Ava支持的本地化语言
  ],
  ...
);

5. Add AvaCard and AvaFloatingButton（添加AvaCard和AvaFloatingButton）

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      ...
      home: Scaffold(
        ...
        body: const Center(
          child: Padding(
            child: AvaCard(), // 添加AvaCard
          ),
        ),
        floatingActionButton: const AvaFloatingButton(), // 添加AvaFloatingButton
      ),
    );
  }
}

Demo Screenshots（演示截图）

示例代码

以下是一个完整的示例代码，展示如何集成 fw_ava_flutter_sdk 插件。

文件：example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:fw_ava_flutter_sdk/fw_ava_flutter_sdk.dart'; // 引入Ava插件

void main() {
  FwAvaFlutterSdkInitializer.init(avaId: "xxxxx"); // 替换为你的avaId
  runApp(const MyApp());
}

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

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: const [
        GlobalMaterialLocalizations.delegate, // 添加Material本地化代理
        AvaLocalizations.delegate, // 添加Ava本地化代理
      ],
      supportedLocales: [
        ...AvaLocalizations.supportedLocales, // 添加Ava支持的本地化语言
      ],
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'), // 设置标题
        ),
        body: const Center(
          child: Padding(
            padding: EdgeInsets.all(20), // 设置内边距
            child: AvaCard(), // 添加AvaCard组件
          ),
        ),
        floatingActionButton: const AvaFloatingButton(), // 添加AvaFloatingButton组件
      ),
    );
  }
}