VonageClientSDKVideo

Vonage Client SDK Video iOS 使您可以在为 iPad、iPhone 和 iPod touch 设备构建的应用程序中使用 Vonage 驱动的视频会话。

所有 Vonage 应用程序都由两部分组成

• 客户端，它使用 Vonage 客户端 SDK 并在用户的浏览器或移动应用程序中运行
• 服务器端，它使用 Vonage 服务器 SDK 并在您的服务器上运行，以将身份验证信息传递给客户端。

用于构建 iOS 应用程序的客户端 SDK 是 Vonage Client SDK Video iOS，它为您的应用程序提供了大部分核心功能，包括

• 连接到 Vonage 会话
• 将流发布到会话
• 订阅会话中的流

客户端 SDK 也可用于 Android 和 web。所有 Vonage 客户端 SDK 都可以相互交互。

您可以在 Vonage 基础知识页面上了解有关 Vonage 客户端、服务器、会话等基础知识的更多信息。

您可以通过添加 https://github.com/opentok/vonage-client-sdk-video.git 存储库作为 Swift Package Dependency 来添加 Vonage Client SDK Video iOS。

要将软件包依赖项添加到您的 Xcode 项目，请选择File > Swift Packages > Add Package Dependency 并输入其存储库 URL。

学习如何使用 Vonage Client SDK Video iOS 的最佳方法是遵循基本视频聊天教程。

一旦您了解了使用 Vonage Client SDK Video iOS 构建的基础知识，您就可以通过 Vonage 开发者指南获得更详细的信息并学习如何自定义您的应用程序。 要调查特定的 API 类和方法，请参阅 Vonage Client SDK Video API 参考。

有关使用 Swift 的示例，请访问我们在 GitHub 上的 Swift 示例应用程序仓库。

有关使用 Objective-C 的示例，请访问我们在 GitHub 上的 Objective-C 示例应用程序仓库。

使用 Vonage Client SDK Video iOS 2.29.0 编写的应用程序可以与使用 Vonage 客户端 SDK 2.27+ 版本编写的 Vonage 应用程序互操作

• Vonage.js
• Vonage Android SDK
• Vonage iOS SDK
• Vonage macOS SDK
• Vonage Windows SDK
• Vonage Linux SDK

OpenTok.xcframework 目录包含 Vonage Client SDK Video iOS。

Vonage Client SDK Video iOS 可作为 Swift Package Manager 或 Pod "VonageXCFramework" 用于 CocoaPods。

Vonage Client SDK Video iOS 需要 Xcode 7 或更高版本。

Vonage Client SDK Video iOS 需要以下框架和库

• AudioToolbox.framework
• AVFoundation.framework
• CoreGraphics.framework
• CoreMedia.framework
• CoreTelephony.framework
• CoreVideo.framework
• Foundation.framework
• GLKit.framework
• libc++.dylib (Xcode 7+ 中为 libc++.tbd)
• libsqlite3.dylib (Xcode 7+ 中为 libsqlite3++.tbd)
• Metal.framework
• MetalKit.framework
• MetalPerformanceShaders.framework
• OpenGLES.framework
• QuartzCore.framework
• SystemConfiguration.framework
• UIKit.framework
• VideoToolbox.framework

Vonage Client SDK Video iOS 链接到 libc++ 标准库。 如果另一个链接到 libc++ 标准库的库是在低于 6.0.0 的 Xcode 版本中编译的，则将其与 Vonage Client SDK Video iOS 一起使用时可能会导致运行时出现段错误。 已知不兼容的库包括但不限于 Firebase（早于 2.1.2 的版本 - 请参阅 https://code.google.com/p/webrtc/issues/detail?id=3992）和 Google Maps（早于 1.9.0 的版本）。 要解决此问题，请下载使用 Xcode 6.0.0 或更高版本编译的其他库的版本。

为了访问摄像头和麦克风，iOS 10 要求您在 Info.plist 文件中为 NSCameraUsageDescription 和 NSMicrophoneUsageDescription 键设置值。 这些定义了出现在应用程序安装程序中的字符串，以告知用户您的应用程序为何使用摄像头和麦克风。 有关更多信息，请参阅 Apple 关于 Cocoa 键的文档。

有关最新版本的 SDK 以及已知问题列表的信息，请参阅发行说明。

有关在后台模式下运行的应用程序中使用 SDK 的信息，请参阅本文档。

Vonage Client SDK Video iOS 在以下设备上受支持

• iPhone - iPhone 5s 及更高版本

• iPad - iPad Pro 第 1 代及更高版本、iPad (2017)、iPad Air（所有型号）、iPad 第 4 代、iPad mini 2 及更高版本

• iPod touch 第 6 代及更高版本

Vonage Client SDK Video iOS 在 iOS 15 或更高版本中受支持。

Vonage Client SDK Video iOS 在 Wi-Fi、4G/LTE 和 5G 连接上受支持。

Vonage Client SDK Video iOS 在 iPhone 5s（支持的最低端设备）上同时支持一个已发布的音视频流、一个已订阅的音视频流以及最多三个额外的已订阅的仅音频流。 在 iPhone 7 上，测试表明支持订阅多达 20 个同步的低分辨率（200x200 像素，每秒 15 帧）流。 要在使用 Vonage Client SDK Video iOS 的会话中连接两个以上的客户端，请创建一个使用 Vonage Media Router 的会话（媒体模式设置为路由的会话）。 请参阅 Vonage Media Router 和媒体模式。

参考文档包含在 SDK 的 doc 子目录中，网址为 http://www.tokbox.com/developer/sdks/ios/reference/index.html。

有关新功能和已知问题列表，请参阅发行说明。