文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>游戏多媒体引擎

导入 SDK 到项目

最近更新时间：2026-05-20 14:49:14

我的收藏

本页目录：

为方便 Flutter 开发者调试和接入腾讯云游戏多媒体引擎产品 API，本文档主要为您介绍适用于 Flutter 开发的工程配置指引。

支持的平台

GME Flutter SDK 支持 iOS、Android、HarmonyOS 平台。

引入 SDK

步骤1：下载 GME Flutter SDK

在 SDK 3.X 下载指引 中下载 SDK 文件，该版本中包括 GME Plugin，请将 SDK 文件解压到本地目录里。
解压后的文件主要分为以下几个部分：
文件名
说明
android
Android 平台插件配置文件。
ios
iOS 平台插件配置文件。
ohos
HarmonyOS 平台插件配置文件。
lib
Flutter 头文件及与 Native SDK 桥接层代码文件。
pubspec.yaml
GME Flutter SDK 依赖配置。

步骤2：增加 Flutter 工程中 GME 插件的依赖

在您的 Flutter 项目中的 pubspec.yaml 文件中添加 GME 的依赖，注意参数中的 path 指上述 SDK 解压的路径。
dependencies:
dependencies:
  flutter:
      sdk: flutter
    gme_flutter:
       path: ../
保存 pubspec.yaml 文件，在 pubspec.yaml 文件的统计目录下在终端（命令行界面）中输入 flutter pub get 命令使您的项目中的 GME 插件生效
flutter pub get

iOS 工程修改

1. 在您的 iOS 工程目录下执行 pod update 命令添加 gme sdk 库到您的 xcode 工程
cd ios
pod update
2. iOS 平台需要在 Xcode 工程 Info.plist 添加隐私权限如下：
Required background modes：允许后台运行（可选）。
Microphone Usage Description：允许麦克风权限。

Android 工程修改

在 Flutter 工程文件 android/app/src/AndroidManifest.xml 中添加工程权限（如已修改请忽略）。
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

HarmonyOS 工程修改

1. 在您的工程 /ohos/oh-package.json5 中添加 GME SDK HAR 包依赖：

{
  "name": "your_project_name",
  "version": "1.0.0",
  "description": "",
  "dependencies": {
    "@aspect/gme_ohos": "file:../../ohos/src/main/libs/GME_OHOS_sdk.har"
  },
2. 在您的工程 /ohos/entry/src/main/module.json5 中 requestPermissions 字段添加 GME 所需权限：

{
    "requestPermissions": [
      { "name": "ohos.permission.KEEP_BACKGROUND_RUNNING" },    // 后台保活（后台语音通话）
      { "name": "ohos.permission.INTERNET" },                  // 网络访问（实时语音通信)
      { "name": "ohos.permission.GET_NETWORK_INFO" },         // 获取网络状态信息
      {
        "name": "ohos.permission.MICROPHONE",
        "reason": "$string:module_desc",                    //  麦克风使用（语音采集）
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "always"
        }
      }
    ]
 }

中国站