Flutter USSD码高级操作插件 ussd_advanced 的使用

ussd_advanced 插件允许你在 Flutter 应用中直接运行 USSD 代码。以下是如何在项目中使用该插件的详细说明。

使用方法

添加依赖

首先，在 pubspec.yaml 文件中添加插件依赖：

dependencies:
  ussd_advanced: ^latest_version

记得将 ^latest_version 替换为最新版本号。

Android 配置

你需要在 Android Manifest 中添加 CALL_PHONE 和 READ_PHONE_STATE 权限：

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

多会话 USSD 支持

对于多会话 USSD，需要在 Android Manifest 的 <application> 标签内添加一个服务：

<service
    android:name="com.phan_tech.ussd_advanced.USSDServiceKT"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE"
    android:exported="false">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/ussd_service" />
</service>

iOS 配置

在 iOS 的 info.plist 文件中添加以下内容：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>tel</string>
</array>

示例代码

以下是完整的示例 Demo：

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

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late TextEditingController _controller;
  String? _response;

  @override
  void initState() {
    super.initState();
    _controller = TextEditingController();
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Ussd Plugin example'),
        ),
        body: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          mainAxisSize: MainAxisSize.max,
          children: [
            // 文本输入框
            TextField(
              controller: _controller,
              keyboardType: TextInputType.phone,
              decoration: const InputDecoration(labelText: 'Ussd code'),
            ),

            // 显示响应（如果有）
            if (_response != null)
              Padding(
                padding: const EdgeInsets.symmetric(vertical: 8),
                child: Text(_response!),
              ),

            // 按钮组
            Row(
              mainAxisSize: MainAxisSize.max,
              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
              children: [
                ElevatedButton(
                  onPressed: () {
                    UssdAdvanced.sendUssd(code: _controller.text, subscriptionId: 1);
                  },
                  child: const Text('普通请求\n(normal request)'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    String? _res = await UssdAdvanced.sendAdvancedUssd(code: _controller.text, subscriptionId: 1);
                    setState(() {
                      _response = _res;
                    });
                  },
                  child: const Text('单会话请求\n(single session request)'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    String? _res = await UssdAdvanced.multisessionUssd(code: _controller.text, subscriptionId: 1);
                    setState(() {
                      _response = _res;
                    });
                    String? _res2 = await UssdAdvanced.sendMessage('0');
                    setState(() {
                      _response = _res2;
                    });
                    await UssdAdvanced.cancelSession();
                  },
                  child: const Text('多会话请求\n(multi session request)'),
                ),
              ],
            )
          ],
        ),
      ),
    );
  }
}

方法说明

• sendUssd: 执行普通的 USSD 请求，不返回响应。
• sendAdvancedUssd: 执行单会话 USSD 请求，并返回响应字符串。仅支持 Android 8+（SDK 26+），如果 SDK 版本较低，则默认使用 sendUssd。
• multisessionUssd: 执行多会话 USSD 请求，返回所有会话的响应字符串。可以使用 sendMessage 方法与 USSD 对话框交互，并通过 cancelSession 取消会话。

选择 SIM 卡

可以通过提供 subscriptionId 参数来选择使用的 SIM 卡：

• -1: 使用手机默认设置。
• 仅支持 Android 6+，如果 SDK 版本较低，默认使用默认 SIM 卡。

希望这些信息能帮助你更好地理解和使用 ussd_advanced 插件！如果你有任何问题或需要进一步的帮助，请随时提问。