快速上手

前提条件

  • Xcode 16.0 或以上版本
  • iOS 9.0或以上版本的真机设备

创建项目并引入SDK

创建iOS项目

  • 打开Xcode 并点击Create a new Xcode project。
  • 选择平台类型为iOS、项目类型为Single View App,并点击Next。
  • 输入项目名称(Product Name)、开发团队信息(Team)、组织名称(Organization Name)和语言(Language)等项目信息,并点击Next。
  • 选择项目存储路径,并点击Create。
  • 设置最低版本及证书。
  • 如果是Xcode11创建的新项目需要删除UISceneSession相关代码
    1.删除info.plist中的Application Scene Manifest 配置项2.删除Appdelegate中UISceneSession的相关代码,并在AppDelegate 中 添加如下代码

获取SDK

1.SDK接口以IOS下标准的framework的形式提供,并提供接口定义C头文件 文件目录说明

  AudioUtilityEngine.framework  TangSDK.bundle  GNetTangSDK.framework  FlowCtrl.framework  AudioEngineCore.framework

导入SDK

  • 找到SDK解压后文件夹里的framework文件夹,拖入新建的项目中,勾选Copy items if needed 。
  • 打开Xcode,进入TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content菜单。 将Embed属性设置为Embed & Sign,项目会自动链接所需系统库。
  • 在target-> info ->custom ios target propertys 添加 App Transport Security Settings ->Allow Arbitrary Loads = YES
  • 点击Build Settings 搜索bitcode,设置Enable Bitcode 属性为NO
  • 如果是Xcode 12.3+进入TARGETS > Project Name > BuildSettings > Validate WorkSpace > YES
  • 相关权限设置添加
    添加相关系统权限申请麦克风、摄像头、相册等资源NSCameraUsageDescription您可以共享视频给其他参会人NSContactsUsageDescription您可以邀请手机通讯录的联系人入会NSLocationWhenInUseUsageDescription"如果不允许,您将无法使用定位"NSMicrophoneUsageDescription您可以使用网络语音入会NSPhotoLibraryAddUsageDescription此App 需要您的同意才能为您添加图片

使用SDK

创建RtcEngine

+ (instancetype)sharedEngineWithAppId:(NSString * _Nonnull)appId                                       logPath:(NSString * _Nullable)logPath                                      delegate:(id<TangRtcEngineDelegate> _Nullable)delegate;+ (instancetype)sharedEngineWithConfig:(TangRtcEngineConfig * _Nonnull)config                                        logPath:(NSString * _Nullable)logPath                                       delegate:(id<TangRtcEngineDelegate> _Nullable)delegate

获取SDK版本

+(NSString * _Nonnull)getVersion;

设置设备角色

- (int)setClientRole:(TangClientRole)role;

销毁SDK

+ (void)destroy;

注意事项

  • 更多接口详细见 文件 TangRtcChannel.h、TangRtcEngineKit.h
  • 如果是Xcode 12.3+进入TARGETS > Project Name> BuildSettings > Validate WorkSpace > YES