Text Chat Accelerator Pack iOS

Text Chat Accelerator Pack 提供了一种功能，可以添加到您的 OpenTok 应用程序中，使用户能够在移动或基于浏览器的设备之间交换文本消息。

Text Chat Accelerator Pack 示例

配置、构建和运行示例应用程序

1. 获取 API 密钥、会话 ID 和 令牌 的值。有关重要信息，请参阅 获取 OpenTok 凭据。

2. 按照 CocoaPods 起步指南 中所述安装 CocoaPods。如果您只对没有 UI 组件的核心部分感兴趣，可以使用此 pod 'OTTextChatAccelerator/Core'

3. 在终端，使用 cd 命令进入您的项目目录，然后输入 pod install。

4. 使用新的 *.xcworkspace 文件在 Xcode 中重新打开您的项目。

5. 将以下空字符串替换为相应的 API 密钥、会话 ID 和令牌值

   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
       // Override point for customization after application launch.
       sharedSession = [[OTAcceleratorSession alloc] initWithOpenTokApiKey:@"apikey" sessionId:@"sessionid" token:@"token"];
       return YES;
   }

6. 使用Xcode在iOS模拟器或设备上构建和运行应用程序。

7. 为了测试文本聊天，我们包含了一个简单的Web应用程序，以使其更容易使用：浏览器-Demo-TextChat。只需打开它，替换相应的API Key、Session ID和Token值。然后保存并加载到浏览器中。

8. 您可能想在其他平台上运行

加速器文本聊天JavaScript
加速器文本聊天Android

示例代码

• 传递会话

  - (OTAcceleratorSession *)sessionOfOTOneToOneCommunicator:(OTOneToOneCommunicator *)oneToOneCommunicator {
      return <#OTAcceleratorSession#>;
  }

• 开始发送文本聊天数据

  // we assume self owns a table tableView
  [self.textChat connectWithHandler:^(OTTextChatConnectionEventSignal signal, OTConnection *connection, NSError *error) {
      if (signal == OTTextChatConnectionEventSignalDidConnect) {
          NSLog(@"Text Chat starts");
      }
      else if (signal == OTTextChatConnectionEventSignalDidDisconnect) {
          NSLog(@"Text Chat stops");
      }
  } messageHandler:^(OTTextChatMessageEventSignal signal, OTTextMessage *message, NSError *error) {
      if (signal == OTTextChatMessageEventSignalDidSendMessage || signal == OTTextChatMessageEventSignalDidReceiveMessage) {
          if (!error) {
              [weakSelf.textMessages addObject:message];
              [weakSelf.tableView reloadData];
          }
      }
  }];

• 停止发送文本聊天数据

  [self.textchat disconnect];

获取OpenTok凭据

要使用OpenTok的框架，您需要一个会话ID、令牌和API密钥，您可以在OpenTok开发者仪表板获取这些值。对于生产部署，您必须使用OpenTok服务器SDK之一生成会话ID和令牌值。

文本聊天信令的JSON要求

在使用OpenTok信令API并与OpenTok文本聊天组件一起使用时，所使用的JSON描述了提交聊天消息时使用的信息。这些信息包括日期、聊天消息文本、发送者别名和发送者ID。该JSON格式如下所示

// var type = "text-chat"

{
    "sentOn" : 1462396461923.305,
    "text" : "Hi",
    "sender" : {
        "alias" : "Tokboxer",
        "id" : "16FEB40D-C09B-4491-A983-44677B7EBB3E"
    }
}

此格式化的JSON被转换为字符串，然后提交给OpenTok信令API。更多详情请参阅

• 信令 - JavaScript
• 信令 - iOS
• 信令 - Android

开发和贡献

有兴趣贡献吗？我们可以❤️拉取请求！请参阅贡献指南。

获取帮助

我们很高兴听到您的声音，所以如果您有任何问题、评论或在该项目中发现虫子，请告知我们！您可以通过以下方式：

• 在这个存储库中开启一个问题
• 查看 https://support.tokbox.com/ 以获取支持选项
• 在推特上关注我们！我们在推特上的用户名是 @VonageDev
• 或者 加入Vonage开发者社区Slack

其他阅读材料

• 请查看开发者文档 https://tokbox.com/developer/