如果你的目标平台为 iOS,你的开发环境需要满足以下需求:
如果你的目标平台为 Android,你的开发环境需要满足以下需求:
flutter doctor
命令检查开发环境和运行环境是否满足要求。一个有效的 Agora 开发者账号。
按照以下步骤,在控制台创建一个 Agora 项目。
在项目管理页面,点击创建按钮。
在弹出的对话框内输入项目名称,选择鉴权机制为 APP ID + Token。
点击提交,新建的项目就会显示在项目管理页中。
Agora 会给每个项目自动分配一个 App ID 作为项目唯一标识。
在 Agora 控制台的项目管理页面,找到你的项目,点击 App ID 右侧的眼睛图标就可以直接复制项目的 App ID。
为提高项目的安全性,Agora 使用 Token(动态密钥)对即将加入频道的用户进行鉴权。
为了方便测试,Agora 控制台提供生成临时 Token 的功能,具体步骤如下:
在控制台的项目管理页面,点击已创建项目的 图标,打开 Token 页面。
输入一个频道名,例如 test,然后点击生成临时Token。临时 Token 的有效期为 24 小时。
下载 Agora-Flutter-Quickstart 仓库。打开 settings.dart
(lib/src/utils/settings.dart
)文件并添加 App ID 和 Token。
const APP_ID = Your_App_ID;
const Token = Your_Token;
在仓库根目录运行以下命令安装依赖项。
flutter packages get
启动示例项目。
flutter run
在界面上输入频道名(必须是生成 Token 时使用的频道名)并选择角色,点击 Join 即可加入频道。
如果运行环境为 Android,对于中国大陆用户,运行 flutter run
时可能会卡在 Running Gradle task 'assembleDebug'...
或出现以下错误:
Running Gradle task 'assembleDebug'...
Exception in thread "main" java.net.ConnectException: Connection timed out: connect
解决方案如下:
build.gradle
文件中,对于 google
和 jcenter
使用国内镜像源。下面的示例代码使用了阿里镜像源。buildscript {
ext.kotlin_version = '1.3.50'
repositories {
// google()
// jcenter()
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/public' }
}
...
allprojects {
repositories {
// google()
// jcenter()
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/public' }
}
}
gradle-wrapper.properties
文件中,将 distributionUrl
设为本地路径。以 gradle 5.6.4 为例,你可以将 gradle-5.6.4-all.zip
文件复制到 gradle/wrapper
目录,然后 distributionUrl
设置为:distributionUrl=gradle-5.6.4-all.zip