SKYKitChat
使用 Skygear Chat iOS SDK
有关如何使用 SKYKitChat
的信息,请参阅 Skygear Chat 快速入门指南:[https://docs.skygear.io/guides/chat/quick-start/ios/](https://docs.skygear.io/guides/chat/quick-start/ios/)
使用 Skygear Chat UIKit
目前仅支持 Swift 3.2 的 UIKit。Swift 4.0 支持正在到来。
要使用 Skygear 中的 UIKit,请按照以下步骤操作
SKYKitChat/UI
1. 在 Podfile 中包含 pod 'SKYKit', '~> 1.1'
pod 'SKYKitChat', '~> 1.1'
pod 'SKYKitChat/UI', '~> 1.1'
之后运行 pod install
。
Info.plist
文件中添加3行来包含3项权限
2. 通过在XCode项目中隐私 - 照片库使用描述
- 推荐描述:应用程序需要访问您的照片库以便在聊天中发送图片
隐私 - 相机使用描述
- 推荐描述:应用程序需要访问您的相机以便在聊天中发送图片
隐私 - 麦克风使用描述
- 推荐描述:应用程序需要访问您的麦克风以便在聊天中发送语音
3. 创建会话对象后打开聊天视图
目前UIKit包括一个内置的聊天视图。在从Chat API获取会话对象后,您可以使用它
let vc = SKYChatConversationViewController()
vc.conversation = conversation // conversation object create from chat sdk
self.navigationController?.pushViewController(vc, animated: true)
基础示例
Swift 3.2中的一个基础示例,将显示一个没有导航栏的SKYChatConversationView,以与用户的ID进行硬编码聊天。
AppDelegate.swift
:
import UIKit
import SKYKit
import SKYKitChat
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
let skygear = SKYContainer.default()
skygear.configAddress("change me with your Skygear API Endpoint")
skygear.configure(withAPIKey: "change me with your Skygear API Key")
skygear.auth.signupAnonymously(completionHandler: { (user, error) in
skygear.chatExtension?.createDirectConversation(userID: "change me with a user ID in your app", title: "Test Group", metadata: nil, completion: { (conversation, error) in
let vc = SKYChatConversationViewController()
vc.conversation = conversation
self.window?.rootViewController = vc
})
})
return true
}
如果您的项目使用Objective-C,并且需要使用UI类,则需要添加生成的接口头文件
#import <SKYKitChat/SKYKitChat-Swift.h>
示例
要运行示例项目,请首先克隆存储库,然后从示例目录运行pod install
。
许可
SKYKitChat依据Apache License,版本2.0提供。更多信息请参阅LICENSE文件。
支持
有关实施相关的问题或技术支持,请访问我们的官方论坛https://discuss.skygear.io或社区聊天https://slack.skygear.io;有关错误报告或功能请求,请随意在这个仓库中提交问题