Flutter插件wluper_plugin_flutter的使用方法详细介绍

在本教程中，我们将介绍如何在Flutter应用程序中使用wluper_plugin_flutter插件。此插件允许用户通过语音识别和自然语言理解与应用程序进行交互。以下是详细的步骤和代码示例。

开始使用wluper_plugin_flutter

1. 添加依赖

在pubspec.yaml文件的dev_dependencies部分添加以下依赖：

dev_dependencies:
  wluper_plugin_flutter: ^1.1.0

然后运行flutter pub get以安装插件。

2. 导入插件

在需要使用插件的地方导入以下库：

import 'package:wluper_plugin_flutter/wluper_plugin_flutter.dart';
import 'package:wluper_plugin_flutter/wluper_plugin_interface.dart';

3. 实现接口

创建一个类并实现WluperPluginInterface协议，以便处理解析树的操作。

class _MyAppState extends State<MyApp> implements WluperPluginInterface {
    ...
}

4. 覆盖方法

覆盖WluperPluginInterface中的方法来处理错误、实时文本和语音结束事件。

@override
void wluperOnError(String error){
    // 在这里实现您的代码
}

@override
void wluperOnLiveText(String text){
    // 在这里实现您的代码
}

@override
void wluperEndOfSpeech(){
    // 在这里实现您的代码
}

5. 声明插件对象

声明一个WluperPluginFlutter对象。

class _MyAppState extends State<MyApp> implements WluperPluginInterface {
    ...
    WluperPluginFlutter wluperSDK = WluperPluginFlutter();
    ...
}

6. 初始化SDK

初始化SDK时需要提供tu_api_key、log_api_key、client_id以及监听器。

Future<void> initPlatformState() async {
    ...
    wluperSDK.init(this, _client_id, _tu_api_key, _log_api_key).then((result) => /* 在这里实现您的代码 */);
    ...
}

7. 包装插件方法

包装插件的方法以供调用。

class _MyAppState extends State<MyApp> implements WluperPluginInterface {
    ...

    void startListening(){
        wluperSDK.startListening().then((result) => /* 在这里实现您的代码 */);
    }

    void understand(text){
        wluperSDK.understand(text).then((result) => /* 在这里实现您的代码 */);
    }

    void cancelListening(){
        wluperSDK.cancelListening().then((result) => setState(() => /* 在这里实现您的代码 */));
    }

    ...
}

8. 调用方法

从UI中调用startListening()、understand(text)和cancelListening()方法。在说话时，实时文本将由监听器wluperOnLiveText接收。语音结束事件会自动检测并在wluperEndOfSpeech回调中通知。

class _MyAppState extends State<MyApp> implements WluperPluginInterface{
    String _status = 'Unknown';
    String _tree = "";
    String _error = "";
    String _plain_text ="";

    void cleanUI(){
        setState(() {
            _status = "";
            _error= "";
            _tree = "";
            _plain_text = "";
        });
    }

    Widget build(BuildContext context) {
        return Column(
            children: <Widget>[
                Text('SDK STATUS', style: TextStyle(fontWeight: FontWeight.bold)),
                Text(_status),
                Row(
                    children: <Widget>[
                        TextButton(style: TextButton.styleFrom(textStyle: const TextStyle(fontSize: 20)),
                            onPressed: () { cleanUI(); startListening(); },
                            child: const Text('Listen')),
                        TextButton(style: TextButton.styleFrom(textStyle: const TextStyle(fontSize: 20)),
                            onPressed: () { cancelListening();},
                            child: const Text('Cancel'))
                    ],
                ),
                Text('ASR OUTPUT', style: TextStyle(fontWeight: FontWeight.bold)),
                TextField(
                    controller: textController,
                    maxLines: 3,
                    decoration: const InputDecoration(border: OutlineInputBorder(), hintText: 'Enter a sentence to understand'),
                ),
                TextButton(style: TextButton.styleFrom(textStyle: const TextStyle(fontSize: 20)),
                    onPressed: () { understand(textController.text); },
                    child: const Text('Understand')),
                Text('BODY RESPONSE', style: TextStyle(fontWeight: FontWeight.bold)),
                Text(_tree),
                Text('ERROR', style: TextStyle(fontWeight: FontWeight.bold)),
                Text(_error),
            ]
        );
    }
}

9. 权限配置

Android

在AndroidManifest.xml中添加录音权限：

<uses-permission android:name="android.permission.RECORD_AUDIO" />

iOS

在Info.plist中添加麦克风和语音识别权限：

<key>NSMicrophoneUsageDescription</key>
<string>Audio is recorded and transcribed.</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>We need to record your voice.</string>