产品动态
公告
Flutter
本文介绍如何快速跑通 Chat Demo 来体验文字、语音、视频等消息发送功能。跑通后运行效果如下图所示：
登录页 | 会话列表页 | 聊天页 |
 |  |  |
快速体验
前提条件
开通服务
1. 登录控制台。如果您已有应用，请记录其
SDKAppID 和密钥信息。2. 单击创建应用，在对话框中输入您的应用名称，选择产品、部署区域，单击创建来创建应用。
3. 创建完成后，可在控制台总览页查看新建应用的
SDKAppID、SDKSecretKey，后续运行 Demo 时需要用到这两个信息。
注意：
请妥善保管 SDKSecretKey，谨防泄露！
环境准备
Flutter >= 3.29.0 版本，Dart >= 3.7.0 版本
Android Studio Ladybug | 2024.2.1 及以上版本，Android Gradle plugin 7.3.1 以上版本，JDK 17 版本。
Xcode 12.0 及以上版本
版本兼容性说明：
为确保构建环境稳定，请严格遵循官方兼容性要求进行配置：
Gradle、Android Gradle Plugin、JDK 与 Android Studio 的兼容性，请参阅 Android 官方文档：版本说明。
Kotlin、Android Gradle Plugin 与 Gradle 的版本对应关系，请参阅 Kotlin 官方文档：Kotlin-Gradle 插件兼容性。
使用 JDK 17 版本，其他版本可能导致编译失败，请参阅：Java 版本切换。
我们建议您根据上述指南，选择与项目要求完全匹配的版本组合。
操作步骤
获取 Demo
说明：
为尊重表情设计版权，Chat Demo/TUIKit 工程中不包含大表情元素切图，正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的小黄脸表情包版权归腾讯云所有，您可以通过升级至 Chat 专业版 Plus 和企业版 免费使用该表情包。
1. 下载即时通信 Flutter Chat UIKit 工程。
2. 使用 Android Studio 打开下载的
chat/demo 项目，Android Studio > File > Open > 选择 demo 根目录，找到对应的 login_page 文件，路径为 lib/login_page.dart。3. 设置
login_page 文件中的相关参数：SDKAppID: 请设置为前文中获取的实际应用
SDKAppID。SecretKey: 请设置为前文中获取的实际密钥信息 。
禁止：
本文提到的获取 UserSig 的方案是在客户端代码中配置 SecretKey，该方法中 SecretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
编译并运行 Demo
用 Android Studio 导入工程，并安装 Flutter 和 Dart 插件。
在项目根目录执行如下命令安装依赖。
flutter pub get
以运行 Android 设备为例：
将 Android 设备连接至电脑，在 Android 设备上打开开发者模式，启用 USB 调试，并且在 Android 设备上选择 USB 用于传输文件（如有）。
在 Android Studio 界面顶部的 Running devices 选项中选择您用来测试的 Android 设备。
点击运行按钮开始编译。编译成功后，您的设备上会自动安装好 Chat App。
打开 App，输入任意 UserID 即可创建并登录用户账号。
为方便测试消息互通，您可以创建两个不同的用户账号，添加好友后互相发送消息。
添加好友 | 搜索好友 | 通讯录新增好友 | 与好友聊天 |
 |  |  |  |
常见问题
iOS 端 Pods 依赖无法安装成功的问题？
方案一：手动删除
ios/Pods 文件夹，及 ios/Podfile.lock 文件，并执行如下命令，重新安装依赖。cd iossudo gem install ffipod install --repo-update
方案二：配置运行后，如果报错，可以单击 Product > Clean Build Folder，清除产物后重新运行
pod install 或 flutter run
Flutter 环境的问题？
如您需得知 Flutter 的环境是否存在问题，请运行 Flutter doctor 检测 Flutter 环境是否装好。
使用 Flutter 自动生成的项目，引入 TUIKit 后，运行 Android 端报错的问题？
1. 打开
android\\app\\src\\main\\AndroidManifest.xml，根据如下，补全 xmlns:tools="http://schemas.android.com/tools" / android:label="@string/android_label" 及 tools:replace="android:label"。<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="替换成您的 Android 端包名"xmlns:tools="http://schemas.android.com/tools"><applicationandroid:label="@string/android_label"tools:replace="android:label"android:icon="@mipmap/ic_launcher" // 指定一个 icon 路径android:usesCleartextTraffic="true"android:requestLegacyExternalStorage="true">
2. 打开
android\\app\\build.gradle，补全 defaultConfig 中 minSdkVersion 及 targetSdkVersion。defaultConfig {applicationId "" // 替换成您的Android端包名minSdkVersion 21targetSdkVersion 30}
Demo 中语音转文字支持的数据中心？
目前语音转文字仅支持中国数据中心的 SDKAppID 体验。
联系我们
文档反馈