Acquire SDK
概述
特性
- 实时聊天。
- 音频/视频聊天(注意:仅限 CORE 版本可用)。
要求
- iOS 10.0+
- XCode 12.0+
框架是用 Swift 5.0 编写的,我们推荐使用 Swift 以实现最简单和最干净的整体整合。
依赖关系
AcquireIO SDK需要依赖Socket.IO-Client-Swift。如果通过Cocoapods安装,将自动包含此依赖项。
SDK 还包含以下第三方代码
- Socket.IO-Client-Swift - iOS/OS X 的 Socket.IO 客户端。
- GoogleWebRTC - iOS 的WebRTC SDK。(仅适用于CORE版本)
这些依赖项已被 vendored 并编译到 SDK 中,这无需采取任何行动,仅为此提供信息。
模块稳定性
模块稳定性支持 Swift 5.1(Xcode 11)及以上版本。这种优势在于 SDK 不再需要为 Swift 编译器的每个新版本重新编译。
Acquire iOS SDK 使用“构建用于分发库”的构建设置构建,这意味着其依赖项也必须以相同的方式构建。但是,截至 2020 年 12 月,Cocoapods 还不支持这一点,因此需要一些解决方案(请参阅安装文档以获取详细信息)。
存储库内容
通过此存储库提供框架包,它包含以下内容
-
README.md - 此文档!
-
AcquireIOSDK.xcframework - 为 iOS 设备提供的 AcquireIO 框架(XCFramework 格式)。如果您不使用依赖管理器,可以手动将其添加到项目中。
-
AcquireIO-Core-Swift.podspec - Cocoapods 所需。您不需要对此文件进行任何操作。
安装
使用 Cocoapods
-
在项目的根目录下创建一个 Podfile(如果尚不存在)
-
在 Podfile 下的目标中添加 AcquireIO-Core-Swift
target :YourTargetName do # Note: use_frameworks! is required to import any dynamic framework. use_frameworks! pod 'AcquireIO-Core-Swift' end
-
将以下内容添加到 Podfile 的底部
post_install do |installer| installer.pods_project.targets.each do |target| if ['GoogleWebRTC', 'Socket.IO-Client-Swift', 'Starscream'].include? target.name target.build_configurations.each do |config| config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES' config.build_settings['ENABLE_BITCODE'] = 'NO' end end end end
-
运行以下命令将SDK安装到您的项目中
$ pod repo update && pod install
-
使用生成的*.xcworkspace文件打开您的项目。
CocoaPods 了解如何安装。
注意:如果您对CocoaPods不熟悉,请访问
开始使用
自iOS 10以来,访问像相机、麦克风这样敏感的隐私数据之前,您必定需要请求授权,否则您的应用在访问它们时会崩溃。
打开您项目中的info.plist文件,右键单击,以源代码打开,将以下代码粘贴到其中。或者,您可以将info.plist默认打开为属性列表,点击添加按钮,在键入时Xcode会提供有关键入“Privacy -”的自动完成建议,使用键盘和
务必在“”之间写明您请求此授权的原因,否则您的应用会被苹果拒绝
<!-- Camera -->
<key>NSCameraUsageDescription</key>
<string>$(PRODUCT_NAME) use camera for video chat</string>
<!-- Microphone -->
<key>NSMicrophoneUsageDescription</key>
<string>$(PRODUCT_NAME) use microphone for voice chat</string>
<!-- Photo Library -->
<key>NSPhotoLibraryUsageDescription</key>
<string>$(PRODUCT_NAME) send photo/video to agent</string>
另外,AcquireIO SDK使用后台模式音频,当您进行视频/语音通话时。如果您没有启用它,则后台语音将不会工作。当UIBackgroundModes密钥包含audio值时,系统媒体框架会自动防止在应用移动到后台时挂起相应应用
要允许AcquireIO SDK在后台播放音频,请按照以下步骤启用它
- 在Xcode的 Navigator 中选择您的项目文件。
- 从功能部分切换到“Background Modes”子部分
- 切换“Background Modes”子部分。在列出后台模式后,勾选“Audio, Airplay & picture in picture”
设置和配置
- 我们的安装指南包含了完整的设置和初始化说明。
- 阅读“配置AcquireIO for iOS”。
- 阅读我们关于推送通知的指南。
- 如果有任何疑问,请通过AcquireIO联系我们,我们只隔了一句话。
关于事件、推送通知、公司数据和用户数据呢?
AcquireIO for iOS支持所有这些功能。有关详细信息,请参阅我们的文档。
帮助与支持
如果您有任何问题或评论,可以通过Acquire联系我们。
许可协议
AcquireIO Cocoapods遵循Apache License, Version 2.0分发。