客户可通过接入iOS SDK快速实现iOS端上的音频通话及视频通话等功能,依托阿里的研发资源,我们为客户提供安全、可靠、弹性、低成本的实时通信服务。

功能特性

提供VoIP to PSTN,PSTN to VoIP, VoIP to VoIP通话场景的服务,接入方可根据需求选择对应的应用场景。

前提条件

  • 客户端需要从阿里云申请融合通信账号后才能接入。您可以使用AddRtcAccount创建账号。
  • 通过融GetRtcToken临时token,作为身份标识与服务进行交互,保证安全性。
    说明 SDK在token即将失效或其他需求而需要更新token时,会通过回调通知接入方,接入方需自行实现接口获取最新token并传递给SDK。
  • 设备以及系统:
    • 支持所有iOS设备。
    • 支持 iOS 8.x 及以上系统。
    • 支持 armv64、armv7、i386、x86_64 四架构,静态库。
  • 开发工具建议使用Xcode 11及以上。

SDK下载地址

IOS端SDK下载地址,请参见iOS数据语音2.1.0

快速开始

  1. 安装CocoaPods。
    使用CocoaPods,目前SDK只能收到引入,所依赖的第三方库需要使用Cocoapods,具体安装流程如下:
    1. 确保电脑已经正确安装Ruby环境(Mac电脑自带,需要确认下是否有安装)
    2. 在Mac终端窗口中输入如下命令:
      sudo gem install cocoapods
  2. 创建新工程。
    • 选择file > new > project创建新工程。
    • 用cocoapods初始化项目。
      1. 进入您所创建项目所在路径,输入如下命令创建Podfile文件。
        pod init
      2. 编辑Podfile文件。
        platform :ios, '8.0'
        target 'AlicomRTCSDKDemo' do
            pod 'OpenSSL', '~> 1.0.203'
            pod 'AliyunOSSiOS'
        end
        注意 如果OpenSSL无法正确安装,建议使用OpenSSL-Universal进行。
  3. 导入SDK。
    • SDK 库名:AlicomRTCSDK.framework
      1. 下载AlicomRTCSDK.framework。
      2. 下载ArtcSDK.framework。
      3. 下载ArtcMediaEngine.framework。
      4. 在工程上右击选择Add Files To>工程名称,将刚刚下载的三个SDK添加进来。
      5. 选择对应的target,选择Frameworks,Libraries,and Embedded Content将ARTCMediaEngine.framework的Embed设置为Embed & Sign。
    • 在工程targetLinked Frameworks and Libraries添加 CoreTelephony.frameworklibc++.tbdlibz.tbd系统库。
    • 在工程 target Build Settings Other Linker Flags 增加 -ObjC 配置。
    • pod依赖:
      • pod 'OpenSSL', '~> 1.0.203'
      • pod 'AliyunOSSiOS'
  4. OC兼容Swift。

    在已有的OC工程中新建一个Swift文件,命名为xxx.swift(名字随便),会弹出提示,选择Create Bridging Header建立桥接文件,系统会建立工程名-Bridging-Header.h

  5. Swift兼容OC。

    创建一个oc文件,命名xxx,继承的父类随便,可以是NSObject,系统弹出提示,选择Create Bridging Header,系统会建立工程名-Bridging-Header.h

  6. 开通后台权限
    由于iOS系统的限制需要注册相应的后台服务才可以在应用退到后台之后继续使用VoIP服务,这边以xcode11.4.1为例具体开通流程如下:
    1. 单击+号。1
    2. 单击Background Modes2
    3. 选择Audio,AirPlay,and Picture in Picture3
  7. 开通麦克风权限Privacy - Microphone Usage Description。4
  8. 关闭bitcode。

    设置Build Settings>Build Options>Enable BitcodeNO

  9. 设置Strip Style。

    选择target>Build Settings>Deployment>Strip Style,将需要编译类型全部设置为Debugging Symbols