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

功能特性

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

开发准备

客户端需要从阿里云申请融合通信账号后才能接入,为了保证安全性,融合通信SDK通过服务端下发的临时token作为身份标识与服务进行交互。临时token可通过融合通信服务pop接口从阿里云获得(详见服务端接入文档),并且具有时效性。SDK在token即将失效或其他需求而需要更新token时,会通过回调通知接入方,接入方需自行实现接口获取最新token并传递给SDK。

SDK下载地址

SDK+Demo下载地址:IOS SDK

crash组件下载:IOS SDK(crash组件)

设备以及系统

  • 支持所有iOS设备
  • 支持 iOS 8.x 及以上系统
  • 支持 armv64、armv7、i386、x86_64 四架构,静态库

快速开始

1.开发环境配置

  • xcode 11及以上
  • 使用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

  • 下载AlicomRTCSDK.framework
  • 下载ArtcSDK.framework
  • 下载ArtcMediaEngine.framework
  • 在工程上右击选择Add Files To “工程名称”,将刚刚下载的三个sdk添加进来
  • 选择对应的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为例具体开通流程如下:

123

7.开通麦克风权限 Privacy - Microphone Usage Description

4

8.关闭bitcode

设置Build Settings -> Build Options -> Enable Bitcode为NO

9.设置Strip Style

在target -> Build Settings -> Deployment -> Strip Style 需要编译类型全部设置为Debugging Symbols