Agora iOS SDK-快速入门

最近有一款应用很火,叫Housparty,Housparty是一款视频群聊应用,最近它在App Store上的下载排名已经超过了Facebook。同时,有媒体称Houseparty已经完成了最新一轮的投资。自己就想着模仿一个玩玩,研究了下,发现有个叫Agora的可以实现部分的功能,就想试用下。
声网Agora.io是一家提供稳定,高可用,有质量保障的实时视频通话和实时全互动直播技术服务的平台,支持全平台,只需要简单集成SKD,即可让应用实现高清视频通话,和多主播实时全互动直播。
既然已经有了SDK,就不需要自己写视频以及通信部分的代码了,这样写一个Housparty的demo就更简单了,下面以iOS平台为例,看下如何集成Agora SDK

环境准备

本文使用的环境如下:

先要注册agora.io,注册完成之后再新建一个项目,需要拿到对应的App ID。后面的示例代码需要使用该App ID
最新的Agora SDK中有两个文件夹:

  • ./libs 中含有的是所需的库(集成到App需要的)
  • ./samples 包含Open Video Call 和 Open Live的代码示例

需要的环境准备好之后,新建一个agora项目,就可以开始配置和集成Agora SDK

添加SDK

先把Agora SDK中./libs复制到agora项目中的agora目录下。再把Agora SDK添加到项目的Libraries中。
添加Libraries的方法:

  1. 选中当前Target(agora)
  2. Build Phases
  3. Link Binary With Libraries
  4. 点击+

Link Binary

这个时候出现的界面是添加系统类库的,选择Add Other ...从项目目录中选中./libs添加里面的内容到Libraries中。这样就添加了Agora SDK
在添加Agora SDK之后,还需要添加Agora SDK所依赖的库,参考官网上面demo使用的libraries,添加以下类库:

  • CoreTelephony.framework
  • CoreMedia.framework
  • VideoToolbox.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • libc++.tbd

build的时候出现错误:

Showing All Messages
  "_res_9_getservers", referenced from:
      agora::commons::network::get_dns_list(bool) in AgoraRtcEngineKit(libmediasdk.a-arm64-master.o)
  "_res_9_ninit", referenced from:
      agora::commons::network::get_dns_list(bool) in AgoraRtcEngineKit(libmediasdk.a-arm64-master.o)
  "_res_9_ndestroy", referenced from:
      agora::commons::network::get_dns_list(bool) in AgoraRtcEngineKit(libmediasdk.a-arm64-master.o)
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

运行官网的demo也出现了同样的错误,说明类库没有导入完整,还需要导入类库是libresolv.9.tbd
类库依赖问题比较容易出现,另一方面也说明没有支持Pod的麻烦,建议Agora能尽快支持CocoaPods
再次build又出现了个问题:

ld: library not found for -lcrypto

问题的原因是:编译时找不到需要的链接库导致的,解决方法:

  1. 选中当前Target(agora)
  2. Build Settings
  3. Search Paths
  4. Library Search Paths
  5. 新增"${PROJECT_DIR}/agora/libs"

Library Search Paths

另外Agora SDK并不支持bitcode,因此需要把bitcode禁止掉,禁止bitcode的方法:

  1. 选中当前Target(agora)
  2. Build Settings
  3. Build Options
  4. Enable Bitcode ->No
bitcode

这样就配置完成了Agora SDK的支持,下面就可以开始使用Agora SDK了。

访问OC类库

Agora SDK使用的是Object-c开发的,而我们的项目使用的是Swift开发的,因此就需要在Swift中访问OC的类库,新建一个文件命名为agora-Bridging-Header.h,在该文件中引入Agora SDK:

#import <AgoraRtcEngineKit/AgoraRtcEngineKit.h>
#import <AgoraRtcCryptoLoader/AgoraRtcCryptoLoader.h>

然后把该文件设置为Objective-C Bridging Header,设置方法:

  1. 选中当前Target(agora)
  2. Build Settings
  3. Swift Compiler-General
  4. Objective-C Bridging Header
  5. agora/agora-Bridging-Header.h

oc bridging

这样能在Swift中使用Agora SDK了。
在开始调用Agora SDK之前还要知道,Agora SDK实现的是一套高清视频通话或直播系统,除了完成集成Agora SDK的工作之外,还需要给项目对应的访问权限。

权限

需要给项目两个权限才能使用Agora SDK,这两个权限是:

  • 相机
  • 麦克风

info.plist添加这两个权限:

info.plist

具体设置的内容为:

  • Privacy - Camera Usage Description设置为:use camera to start video call
  • Privacy - Microphone Usage Description设置为use microphone to start video call

这样完成了Agora SDK的项目配置,后面将继续写如何使用Agora SDK,包含的功能:

  1. 创建room
  2. 分屏,2分屏、4分屏、6分屏
  3. 窗口切换
  4. 前后摄像头切换

项目地址:https://github.com/jjz/agora-swift

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,290评论 4 363
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,399评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,021评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,034评论 0 207
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,412评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,651评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,902评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,605评论 0 199
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,339评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,586评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,076评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,400评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,060评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,083评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,851评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,685评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,595评论 2 270

推荐阅读更多精彩内容

  • 转载自:https://github.com/Tim9Liu9/TimLiu-iOS[https://github...
    香橙柚子阅读 8,122评论 0 35
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,616评论 4 59
  • 一直有写作的想法,然而拿起笔来思绪又是混乱的,什么都想写什么都写不出来。我想我的问题也是很多人的问题,然而因此放弃...
    哈奔奔阅读 217评论 0 0
  • 姐,我发现你的肩膀肌肉有点紧,而且大椎这里有个大肉包,是不是平时会有酸痛脖子僵硬的感觉呀?你可不要小看肩颈问题呀,...
    欧甜汐阅读 3,408评论 0 3
  • 不曾言语的时候别怀疑是不是我 尽管只是一条小溪趟过也会湿了裤管 追逐本身就是一场梦 得到对比失去哪有公平可言
    张钊z阅读 194评论 0 0