Flutter 与 Android 原生交互（MethodChannel 实战）

洋漾 2025-06-14 PM 38℃ 0条

>在实际的 Flutter 开发中，往往会遇到一些 Flutter 无法直接处理的系统层操作，例如音频增强、系统音量控制、通知监听等。这时候，我们就需要通过 **平台通道（Platform Channels）** 调用原生平台（Android/iOS）的 API 来实现目标功能。

本文以 Android 为例，系统讲解 Flutter 与 Android 原生交互的流程，适合初学者和中高级开发者查漏补缺。

---

## 一、基本原理：什么是 MethodChannel？

Flutter 与原生之间的通信依靠的是 Platform Channel，最常用的是 `MethodChannel`，它可以让 Dart 调用原生方法并获取返回结果。

通信流程如下：

---

## 二、实战案例：音频增强控制

假设我们有一个页面 `VolumePage`，Flutter 需要通过 Android 原生实现以下功能：

- `startAudioEnhancer`：启动增强
- `stopAudioEnhancer`：关闭增强
- `getCurrentMusicInfo`：获取当前播放音乐信息
- `setSystemVolume`：设置系统音量
- `getSystemVolume`：获取当前音量百分比

---

## 三、Flutter 端代码（Dart）

#### 创建通道并调用方法

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

class NativeBridge {
  static const MethodChannel _channel = MethodChannel('com.example.audio');

static Future<void> startAudioEnhancer() async {
    await _channel.invokeMethod('startAudioEnhancer');
  }

static Future<void> stopAudioEnhancer() async {
    await _channel.invokeMethod('stopAudioEnhancer');
  }

static Future<Map<String, dynamic>> getCurrentMusicInfo() async {
    final result = await _channel.invokeMethod('getCurrentMusicInfo');
    return Map<String, dynamic>.from(result);
  }

static Future<void> setSystemVolume(int volume) async {
    await _channel.invokeMethod('setSystemVolume', {"volume": volume});
  }

static Future<int> getSystemVolume() async {
    final result = await _channel.invokeMethod('getSystemVolume');
    return result;
  }
}
```

## 四、Android 原生端（Kotlin）

#### 注册通道并实现方法

```
class MainActivity: FlutterActivity() {
    private val CHANNEL = "com.example.audio"

override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)

MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler {
            call, result ->
            when (call.method) {
                "startAudioEnhancer" -> {
                    startAudioEnhancer()
                    result.success(null)
                }
                "stopAudioEnhancer" -> {
                    stopAudioEnhancer()
                    result.success(null)
                }
                "getCurrentMusicInfo" -> {
                    val musicInfo = getCurrentMusicInfo()
                    result.success(musicInfo)
                }
                "setSystemVolume" -> {
                    val volume = call.argument<Int>("volume") ?: 50
                    setSystemVolume(volume)
                    result.success(null)
                }
                "getSystemVolume" -> {
                    val volume = getSystemVolume()
                    result.success(volume)
                }
                else -> result.notImplemented()
            }
        }
    }

private fun startAudioEnhancer() {
        // 调用音频增强逻辑
    }

private fun stopAudioEnhancer() {
        // 停止增强逻辑
    }

private fun getCurrentMusicInfo(): Map<String, String> {
        return mapOf(
            "title" to "音乐标题",
            "artist" to "艺术家"
        )
    }

private fun setSystemVolume(volume: Int) {
        val audioManager = getSystemService(AUDIO_SERVICE) as AudioManager
        val maxVolume = audioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC)
        val newVolume = (volume * maxVolume / 100.0).toInt()
        audioManager.setStreamVolume(AudioManager.STREAM_MUSIC, newVolume, 0)
    }

private fun getSystemVolume(): Int {
        val audioManager = getSystemService(AUDIO_SERVICE) as AudioManager
        val current = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC)
        val max = audioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC)
        return (current * 100.0 / max).toInt()
    }
}
```

##  五、权限声明（AndroidManifest.xml）

```
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
```

标签: flutter, dart

非特殊说明，本博所有文章均为博主原创。

如若转载，请注明出处：https://blog.cnccy.com/222.html

上一篇 antd pro v5 设置请求头参数、全局错误提示、publicPath、设置mock、代理等网络设置

下一篇 🌍 出海开发 Google Play 应用注意事项总结

评论啦~

永远年轻永远热泪盈眶2025年06月14日 17:04:31
做认为正确的事，一直坚持下去。2024年07月22日 11:20:56
做难事必有所得，别让平淡杀灭你的志气2021年11月20日 23:05:39
专注、自省、简单朴实、自律、艰苦奋斗、坚韧、舍得放权、淡泊名利、居安思危、终身学习2021年07月06日 10:47:00
懂得越多，越发觉懂得越少。2021年02月05日 19:58:59
小米即时消息mimc很赞，文档链接：https://admin.mimc.chat.xiaomi.net/docs/2020年04月05日 20:59:00

Flutter 与 Android 原生交互（MethodChannel 实战）

评论啦~

广而告之

栏目分类

博主动态 ~

标签云

Flutter 与 Android 原生交互（MethodChannel 实战）

 评论啦~

广而告之

 栏目分类

博主动态 ~

标签云

评论啦~

广而告之

栏目分类

博主动态 ~

标签云