可充FaceSDK iOS接入文档

环境:
iOS 9.0+ / Mac OS X 10.14+
Xcode 10.0+
Swift 4.0+

SDK导入

1.1 手动导入

Swift4.x
Swift5.x

将KCFaceSDK/文件中的KCFace.framework,KCFaceBundle.bundle,KCFace.swift 导入你的项目中

image.png

使用

import KCFace

1.2 [推荐]pod方式导入

use_frameworks! #注意如果pod中没有请添加use_frameworks!,如果被注释请取消注释
pod 'KCFaceKit', '~> 1.0.0'#Swift4.x版本请使用1.0.0以下(不包含1.0版本)例:pod 'KCFaceKit'~>0.1.0'

1.3 info.plist文件中添加相机隐私权限及描述

Privacy - Camera Usage Description App需要您的同意,才能访问相机，以便于识别你的面部信息

2 用法

• 2.1 Swift调用

• 2.1.1 [推荐]pod导入后可直接使用(库名)KCFace.方法名

//配置SDK
KCFace.configSDK("kechong", "cus", "", "", "kc", "kechong")
///如果app需要SDK提示用户开通免密支付需设置代理对线并实现代理方法
KCFace.delegate = self
///启动SDK Ui
KCFace.showKCFace(self) { (bool, desc) in
    if bool == true {
        print("sdk唤起成功!")
    }else{
        print("SDK唤起失败\(desc)")
    }
}

///修改添加微信免密签名id
//在调用前请先确定 已经调用过configSDK()配置SDK参数
KCFace.updateContractId("contractId") { (bool) in
    if bool == true {
        print("修改成功!")
    }else{
        print("修改失败")
    }
}

/*获取平台消费记录*/
//在调用前请先确定 已经调用过configSDK()配置SDK参数 
KCFace.payRecords(0, 0) { (bool, resp) in
    if bool == true {
        //成功
        print("成功!\(resp)")
    }else{
        //
        print("失败\(resp)")
    }
}

或 KCSDKManager

//配置SDK参数
let manager = KCSDKManager.sharedInstances
///设置代理
manager.delegate = self
//配置SDK
manager.configSDK("kechong", "cus", "", "", "kc", "kechong")
//启动SDK
manager.showKCFace(self) { (bool, desc) in
    if bool == true {
        print("sdk唤起成功!")
    }else{
        print("SDK唤起失败\(desc)")
    }
}

• 2.2 oc调用

1,如过是纯OC的项目,需要在项目中新建一个swift文件(名字随意)然后根据提示添加桥接文件(注意:创建的.swift文件不能删除 oc/swift混编略过)

桥接.png

2,设置项目swift版本为 SDK对应的最低支持版本及以上(project->Build Settings ->Swift Compiler -Language -> Swift Language Version )

//导入
#import <KCFace/KCFace.h>

//配置SDK 并启动SDK
KCSDKManager *manager = [KCSDKManager sharedInstances];
manager.delegate = self;
[manager configSDK:@"kechong" :@"cus" :@"" :@"" :@"kc" :@"kechong"];
[manager showKCFace:self complete:^(BOOL isSuss, NSString * _Nonnull desc) {
    if (isSuss) {
        NSLog(@"成功:%@",desc);
    }else{
        NSLog(@"失败:%@",desc);
    }
}];

3.Other

pod search KCFaceKit 搜索库提示错误/或者搜索不到
[!] Unable to find a pod with name, author, summary, or description matching `KCFaceKit`

在终端进行以下操作

pod setup

pod repo update

//更新repo完成后 还是搜索不到KCFaceKit在终端中执行 
rm ~/Library/Caches/CocoaPods/search_index.json

//再执行 search pod会重新创建本地pod库索引
pod search KCFaceKit

KCFace.framwrok包含真机和模拟器环境在发布时需要去除i386/x86_64

• 添加自动去除模拟器平台脚本
  选中项目->TARGETS(项目)->Build Phases
  创建脚本.png

复制以下脚本代码到script中即可

 APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"
 
  # This script loops through the frameworks embedded in the application and
  # removes unused architectures.
  find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
  do
  FRAMEWORK_EXECUTABLE_NAME=$(defaults read    "$FRAMEWORK/Info.plist" CFBundleExecutable)
  FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTAB LE_NAME"
  echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"
 
  EXTRACTED_ARCHS=()
 
  for ARCH in $ARCHS
  do
  echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"
  lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o       "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
  EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
 done
 
  echo "Merging extracted architectures: ${ARCHS}"
  lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create   "${EXTRACTED_ARCHS[@]}"
  rm "${EXTRACTED_ARCHS[@]}"
 
  echo "Replacing original executable with thinned version"
  rm "$FRAMEWORK_EXECUTABLE_PATH"
  mv "$FRAMEWORK_EXECUTABLE_PATH-merged"    "$FRAMEWORK_EXECUTABLE_PATH"
 
  done

添加脚本.png

或者cd进framework目录手动移除

lipo -info KCFace.framework/KCFace  # Architectures in the fat file: KCFace are: i386 x86_64 armv7 armv7s arm64
# 移除x86_64, i386
lipo -remove x86_64 KCFace.framework/KCFace -o KCFace.framework/KCFace
lipo -remove i386 KCFace.framework/KCFace -o KCFace.framework/KCFace
# 再次查看
lipo -info KCFace.framework/KCFace # Architectures in the fat file: KCFace are: armv7 armv7s arm64