更新日期:2022-02-18iOS接入文档
支持平台:iPod Touch,iPhone,iPad
系统要求:iOS8.0+
支持框架: armv7,arm64
环境要求:xcode13.0+
2.1. 添加SDK
将 SDK 文件 CsSDK.frameworkt 和 CsRes.bundle 拖放导入工程,选择正确的target
在Build Settings->Linking->Other Linking Flags 中配置 –ObjC
如果在编译时报错找不到framework头文件,需要手动配置一下framework搜索路径,比如demo中的相对路径配置
添加系统 framework:WebKit.framework 和 JavaScriptCore.framework
2.2. 权限申请
SDK 权限申请在Info.plist设置读取相册和使用相机权限描述
NSCameraUsageDescription 需要使用相机用于给客服发送图片信息
NSPhotoLibraryUsageDescription 需要使用相册用于给客服发送图片信息
NSPhotoLibraryAddUsageDescription 需要使用相册用于给客服发送图片信息
2.3. 注意事项
客服系统只支持竖屏,因此需要允许应用的 window 支持竖屏,需要在 AppDelegate 中设置实现或者修改(针对工程已经添加了该方法)如下系统回调方法并返回全方向
UIInterfaceOrientationMaskAll - (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(nullable UIWindow *)window { return UIInterfaceOrientationMaskAll; }
3.1. 设置客服对应语言和 AppId(必接)
/** *初始化客服系统:指定appid和客服语言,该接口可多次调用设置多个appid用于支持不同的语言,一个appid对应一种语言,SDK会自动匹配设备当前语言来选择使用哪一个appid *@param language appid对应的客服语言,(简体中文@"zh-cn", 中文繁体香港@"zh-hk", 中文繁体台湾@"zh-tw", 德语@"de", 英语@"en-us", 法语@"fr", 日语@"ja-jp", 韩语@"kor", 俄语@"ru", 泰语@"th") *@param appid 客服appid参数,参数在客服SDK后台申请 */ - (void)setLanguage:(NSString *)language appid:(NSString *)appid;
//打开客服,上传参数请查看CSParamModel.h - (void)enterServiesystem:(CSParamModel *)param;
/** *有新客服消息时接收本地通知 *在- (void)application:(UIApplication *)application didReceiveLocalNotification:(nonnull UILocalNotification *)notification;中调用以获取新消息 *@param application application参数 *@param notification notification本地通知 */ - (void)application:(UIApplication *)application didReceiveLocalNotification:(nonnull UILocalNotification *)notification;
/** *注册苹果远程通知APNS,用于远程通知推送消息,如果没有远程推送可以不调用 *在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;中调用 */ - (void)registerForRemoteNotifications;
/** *获取苹果返回的deviceToken用于接收远程推送通知,如果没有远程推送可以不调用 *在- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken;中调用以获取推送的deviceToken *@param deviceToken 苹果返回的deviceToken */ - (void)didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken;
//显示客服浮动菜单 - (void)showMenu; //隐藏客服浮动菜单 - (void)hideMenu;
李先生:13880511661
QQ:48157910
赵先生:15390049857
QQ:1077535763
孙女士:13551010407
QQ:1799614139
QQ群:698731538