接入智能教练SDK及参数设置

简要描述

主要协助第三方App接入智能教练SDK，并且设置相应参数的功能代码示例；

主要内容

  • 接入SDK

    SDK支持版本：iOS9+

  1. 引入方式：
    智能教练SDK以framework框架的方式接入，将framework文件夹拖入工程，并设置Embed & Sign。
    设置Framework

  2. 设置工程info.plist权限：
    相机权限：NSCameraUsageDescription
    麦克风权限：NSMicrophoneUsageDescription
    图库权限：NSPhotoLibraryUsageDescription

  3. 关闭bitcode设置：

  • 初始化SDK

  1. #import "PHAISparring/PHAISparring.h"
  3. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  4.     // 创建配置
  5.     PHAISparringConfig *config = [[PHAISparringConfig alloc] init];
  6.     // 开发环境，测试
  7.     config.environment = PHAISparringEnvironmentDebug;
  8.     // 初始化SDK
  9.     [PHAISparring initializeWithConfig:config];
  10.     return YES;
  11. }

  • 进入SDK业务页面

    每个陪练项目都会生成一个项目code，而智能陪练SDK业务依赖code，此处介绍通过WKWebView的代理拦截，获取到云学堂协议并解析处理，跳转到相应的智能陪练页面
  1. #import "PHAISparring/PHAISparringManager.h"
  3. - (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler {
  4.     NSLog(@"url = %@",navigationAction.request.URL.absoluteString.stringByRemovingPercentEncoding);
  6.     // 判断是否为云学堂智能陪练业务协议
  7.     if ([navigationAction.request.URL.absoluteString hasPrefix:@"yxtapp://biz.sparring"]) {
  8.         // 解析协议参数
  9.         NSDictionary *dic = [self getSparringCodeProtocolUrl:navigationAction.request.URL];
  10.         NSString *name = dic[@"name"];
  11.         NSString *code = dic[@"code"];
  12.         NSString *isPreview = dic[@"isPreview"];
  13.         // 处理是否预览
  14.         if (isPreview) {
  15.             PHAISparring.isPreview = [isPreview boolValue];
  16.         } else {
  17.             PHAISparring.isPreview = NO;
  18.         }
  19.         if ([name isEqualToString:@"yxt_app_sparring_start"]) {
  20.             // 开始训练
  21.             [PHAISparring startWithCode:code sender:self];
  22.         }else if ([name isEqualToString:@"yxt_app_sparring_open"]) {
  23.             // 进入智能陪练H5页面
  24.             [PHAISparring openPageWithCode:code sender:self];
  25.         }
  26.         decisionHandler(WKNavigationActionPolicyCancel);
  27.         return;
  28.     }
  29.     decisionHandler(WKNavigationActionPolicyAllow);
  30. }
  32. /// 解析协议参数
  33. /// @param url 协议地址
  34. - (NSDictionary *)getSparringCodeProtocolUrl:(NSURL *)url {
  35.     NSString *paramStr = [[[url.query componentsSeparatedByString:@"&"] firstObject] stringByReplacingOccurrencesOfString:@"param=" withString:@""].stringByRemovingPercentEncoding;
  36.     NSDictionary *paramDic = [NSJSONSerialization JSONObjectWithData:[paramStr dataUsingEncoding:NSUTF8StringEncoding] options:NSJSONReadingMutableContainers error:nil];
  37.     return paramDic;
  38. }

  • SDK方法介绍

  1. //  PHAISparringManager.h
  3. @interface PHAISparring : NSObject
  5. /// 初始化配置
  6. /// @param config 配置模型
  7. + (void)initializeWithConfig:(PHAISparringConfig *)config;
  8. /// 开始训练
  9. + (void)startWithCode:(NSString *)code sender:(UIViewController *)sender;
  10. /// 结束训练
  11. + (void)stopWithCompletion:(void (^ __nullable)(void))completion;
  12. /// 打开智能陪练h5页面
  13. + (void)openPageWithCode:(NSString *)code sender:(UIViewController *)sender;
  15. @end