Respoke SDK for iOS

Respoke SDK for iOS 简化了向移动应用程序添加实时语音、视频、文本和数据功能的过程。有关如何使用 SDK 的信息，请参阅我们的开发者文档和示例应用程序。

https://docs.respoke.io/

安装 SDK

Respoke iOS SDK 通过 CocoaPods 提供。

将以下代码添加到您的Podfile

pod 'RespokeSDK'

然后运行

pod install

贡献

我们欢迎为每个人改进 SDK 的拉取请求。在提交更改时，请确保您在提交之前已运行 SDK 测试用例，并添加/修改了受您改进影响的任何测试用例。

运行 SDK 测试用例

要运行测试用例，请执行以下操作：

1) 创建一个 Respoke 开发者账户，并在 开发者控制台 中定义一个 Respoke 应用程序。记住您创建的 Respoke 应用程序的 应用 ID。

2) 将此仓库克隆到您的开发机器上。

3) 打开 RespokeTestCase.h 并将宏 TEST_APP_ID 的值更改为步骤 1 中收到的 Respoke 应用程序 ID。

4) 如下所述在 Chrome 或 Firefox 中启动 Web TestBot，传递您在步骤 1 中收到的 Respoke 应用程序 ID 作为 URL 的参数。

5) 在 Xcode 中打开 RespokeSDK 工作区并选择 Product -> Test。

6) 测试用例将会运行，结果将在 Xcode 中显示。您还将看到在运行 TestBot 的 Web 浏览器中的调试信息和视频。

** 注意：由于测试用例涉及带有音频和视频的功能测试，因此您需要使用物理 iOS 设备。iOS 模拟器无法通过所有测试用例。

启动 Web TestBot

使用RespokeCall的功能测试用例需要一个基于Respoke.js的特定Web应用，该应用已设置为自动响应SDK测试用例执行的特定操作。由于Web应用将使用音频和视频，因此它需要来自支持WebRTC的浏览器的特殊用户权限，并且通常需要用户交互。因此，它必须从Web服务器上下文运行，或者使用带有特定命令行参数的Chrome从文件系统中加载html文件。

此外，Xcode测试项目已被设置为期望Web应用连接到Respoke，并使用以下格式的端点ID

testbot-username

此用户名是您在运行测试时登录到您的开发计算机的用户，这是为了避免在多个开发者同时运行多个测试Web应用实例时可能发生的冲突。

要设置您的系统执行这些测试，请执行以下操作之一

A）使用Chrome从文件加载html。

1）您可以使用命令行参数使用Chrome加载测试机器人，在测试期间使用假音频和视频源。在Mac OS上，命令看起来类似于以下内容

$ "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
--use-fake-ui-for-media-stream \
--use-fake-device-for-media-stream \
--allow-file-access-from-files \
./RespokeSDKTests/WebTestBot/index.html &

2）文件加载完毕后，将您的本地用户名和Respoke应用程序ID添加到URL中，以便在测试运行时Xcode可以搜索。

file:///respoke-sdk-ios/RespokeSDKTests/WebTestBot/index.html#?un=mymacusername&app_id=my-respoke-app-id

3）运行SDK测试用例。

B）使用本地Web服务器运行。

1）安装http-server

$ sudo npm i -g http-server

2）从测试机器人目录启动http-server

$ cd RespokeSDKTests/WebTestBot/
$ http-server

3）使用命令行参数启动Chrome，使用假音视频并自动接受媒体权限，无需人工交互

$ /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --use-fake-ui-for-media-stream --use-fake-device-for-media-stream

这也可以通过访问“about:config”然后设置“media.navigator.permission.disabled”选项为TRUE，在Firefox中完成。

4）通过加载https://:8080/#?un=mymacusername&app_id=my-respoke-app-id在Chrome标签页中打开测试机器人

5）运行SDK测试用例。

许可证

Respoke SDK和演示应用程序根据MIT许可证授权。有关详细信息，请参阅LICENSE文件。