快速上手
前提条件
- 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