Flutter零售助手插件slang_retail_assistant的使用

在本教程中，我们将介绍如何在Flutter应用中集成并使用slang_retail_assistant插件。通过以下步骤，您可以快速实现一个支持语音助手功能的应用。

1. 集成插件

首先，在您的pubspec.yaml文件中添加slang_retail_assistant依赖：

dependencies:
  slang_retail_assistant: ^版本号

然后运行以下命令以安装依赖：

flutter pub get

2. 初始化插件

在您的主应用类中初始化SlangRetailAssistant。以下是一个完整的示例代码：

示例代码：main.dart

import 'dart:convert';

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

import 'package:slang_retail_assistant/slang_retail_assistant.dart';

void main() {
  runApp(new MaterialApp(
    home: new MyApp(),
    debugShowCheckedModeBanner: false,
  ));
}

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

class _MyAppState extends State<MyApp>
    implements
        RetailAssistantLifeCycleObserver,
        RetailAssistantVoiceAssistListener {
  String _searchText = ''; // 搜索结果文本
  String _utteranceText = ''; // 用户输入文本

  [@override](/user/override)
  void initState() {
    super.initState();
    initSlangRetailAssistant();
  }

  void initSlangRetailAssistant() {
    var assistantConfig = new AssistantConfiguration()
      ..assistantId = "<AssistantId>" // 替换为您的助理ID
      ..apiKey = "<ApiKey>" // 替换为您的API密钥
      ..enableCustomTrigger = true;

    SlangRetailAssistant.initialize(assistantConfig);
    SlangRetailAssistant.setLifecycleObserver(this);
    SlangRetailAssistant.setOnSearchListener((searchInfo, searchUserJourney) {
      setState(() {
        try {
          JsonEncoder encoder = const JsonEncoder.withIndent('  ');
          String searchMapString = encoder.convert(searchInfo);
          _searchText = searchMapString.toString();
        } catch (e) {
          print(e);
        }
      });
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
        debugShowCheckedModeBanner: false,
        home: Scaffold(
            appBar: AppBar(
              title: const Text('Slang Retail PlayGround App'),
            ),
            body: Center(
                child: Column(
              mainAxisSize: MainAxisSize.max,
              children: [
                Container(height: 25),
                Row(
                  children: [
                    Expanded(
                      child: Container(
                          height: 45.0,
                          margin:
                              const EdgeInsets.fromLTRB(17.0, 0.0, 10.0, 0.0),
                          child: TextField(
                            controller:
                                TextEditingController(text: _utteranceText),
                            decoration: InputDecoration(
                              labelText: 'Utterance Text',
                              suffixIcon: GestureDetector(
                                onTap: () {
                                  Clipboard.setData(
                                      ClipboardData(text: _searchText));
                                  ScaffoldMessenger.of(context).showSnackBar(
                                    const SnackBar(
                                        content: Text('Utterance text copied')),
                                  );
                                },
                                child: Icon(Icons.copy),
                              ),
                              border: OutlineInputBorder(
                                borderRadius: BorderRadius.circular(10.0),
                                borderSide: const BorderSide(
                                  color: Colors.blue,
                                  width: 2.0,
                                ),
                              ),
                            ),
                            onChanged: (value) {
                              _utteranceText = value;
                            },
                          )),
                    ),
                    Container(
                      height: 60,
                      width: 60,
                      margin: const EdgeInsets.only(right: 10.0),
                      child: Padding(
                          padding: const EdgeInsets.all(
                              8.0), // 调整内边距以适应需求
                          child: SlangConvaTrigger(
                            enableCircularBackground: true,
                          )),
                    ),
                  ],
                ),
                Container(height: 30), // 设置间距
                Flexible(
                    child: FractionallySizedBox(
                        widthFactor: 0.9,
                        heightFactor: 0.98,
                        child: SingleChildScrollView(
                            physics: const AlwaysScrollableScrollPhysics(),
                            child: Container(
                              height: MediaQuery.of(context).size.height,
                              decoration: const BoxDecoration(
                                shape: BoxShape.rectangle,
                                color: Colors.black,
                              ),
                              child: Padding(
                                padding: const EdgeInsets.all(16.0),
                                child: Text(
                                  '$_searchText\n',
                                  style: const TextStyle(
                                      fontSize: 20.0,
                                      fontWeight: FontWeight.bold,
                                      color: Colors.white),
                                ),
                              ),
                            ))))
              ],
            ))));
  }

  // 实现生命周期回调
  [@override](/user/override)
  void onAssistantClosed(bool isCancelled) {
    print("onAssistantClosed " + isCancelled.toString());
  }

  [@override](/user/override)
  void onAssistantInitFailure(String description) {
    print("onAssistantInitFailure " + description);
  }

  [@override](/user/override)
  void onAssistantInitSuccess() {
    print("onAssistantInitSuccess");
  }

  [@override](/user/override)
  void onAssistantInvoked() {
    print("onAssistantInvoked");
  }

  [@override](/user/override)
  void onAssistantLocaleChanged(Map<String, String> locale) {
    print("onAssistantLocaleChanged " + locale.toString());
  }

  [@override](/user/override)
  void onOnboardingFailure() {
    print("onOnboardingFailure");
  }

  [@override](/user/override)
  void onOnboardingSuccess() {
    print("onOnboardingSuccess");
  }

  [@override](/user/override)
  void onUnrecognisedUtterance(String utterance) {
    print("onUnrecognisedUtterance " + utterance);
  }

  [@override](/user/override)
  void onUtteranceDetected(String utterance) {
    print("onUtteranceDetected " + utterance);
    _utteranceText = utterance;
  }

  [@override](/user/override)
  void onMicPermissionDenied() {
    print("onMicPermissionDenied");
  }

  [@override](/user/override)
  void onMicPermissionGranted() {
    print("onMicPermissionDenied");
  }

  [@override](/user/override)
  void onCoachmarkAction(AssistantCoachmarkType coachmarkType,
      AssistantCoachmarkAction coachmarkAction) {
    print(
        "onCoachmarkAction CoachmarkType=$coachmarkType CoachmarkAction=$coachmarkAction");
  }

  [@override](/user/override)
  void onVoiceAssistEnd(String promptId, String promptText, bool b) {
    print("onVoiceAssistEnd promptId " +
        promptId +
        " promptText " +
        promptText +
        " boolean " +
        b.toString());
  }

  [@override](/user/override)
  void onVoiceAssistStart(String promptId, String promptText) {
    print("onVoiceAssistStart promptId " +
        promptId +
        " promptText " +
        promptText);
  }
}