# K12开发文档

wx.navigateToMiniProgram({
	appId:'wx5931af4836330935', //采集小程序appid
	path:'/pages/face_take_photos/take_photos?is_first=1', //小程序路径
	extraData: {
		type:'take_photo',//采集跳转
		user_name: '张三',   //刷脸用户姓名
		school_name:'深圳中学', //学校
		user_type:'STAFF', //职业(STUDENT：学生,STAFF：职员)
		student_info:{'class_name':'1班'}, //class_name:班级，user_type为STUDENT时必传
		staff_info:{'occupation':'教师'}, //occupation:职业, user_type为STAFF时必传
		school_list:["深圳中学", "宝安中学"],// 学校列表，至少包含本学校
		organization_id: 'O1947FD2089aed8785', //organazition_id
		out_user_id: 'test',  // out_user_id，商户侧的用户ID，唯一不可重复
		account:'15988866666', // 签约手机号
		token:'XCXab19673d0d0b5c0ffd980fb60ce82f5e', //商户认证凭据
	},
	envVersion: 'trial',    // 如果要跳转体验版，加上这个参数，否则请不要加这个参数
	success(res) {
		// 成功跳转到签约小程序
	},
	fail(res) {
		// 未成功跳转到签约小程序
	}
})

{
	appId:'wx5931af4836330935', //采集小程序appid
	extraData:{
		'return_code':'SUCCESS',  //状态码
		'return_msg':'录入成功',   //提示信息
	}
}

wx.navigateToMiniProgram({
	appId:'wx5931af4836330935', //小程序id
	path:'/pages/face_index/index?is_first=1', //小程序路径
	extraData: {
		type:'sign',//签约跳转
		user_name: '张三',   //刷脸用户姓名
		school_name:'深圳中学', //学校
		user_type:'STAFF', //职业(STUDENT：学生,STAFF：职员)
		student_info:{'class_name':'1班'}, //class_name:班级，user_type为STUDENT时必传
		staff_info:{'occupation':'教师'}, // occupation:职业, user_type为STAFF时必传
		school_list:["深圳中学", "宝安中学"],// 学校列表，至少包含本学校
		organization_id: 'oea567edbgADeG', // 机构ID
		out_user_id: 'SEGdget123987789',  // 商户侧用户ID
		account:'15988866666', // 签约手机号
		token:'PRESIGN_DGET1233543djgegeedde'
	},
	success(res) {
		// 成功跳转到签约小程序
	},
	fail(res) {
		// 未成功跳转到签约小程序
	}

})

referrerInfo字段说明 {
	appId:'wx5931af4836330935',
	extraData:{
		'return_code':'SUCCESS',
		'return_msg':'签约成功',
	}
}

wx.navigateToMiniProgram({
	appId:'wx5931af4836330935', // 确认小程序appid
	path:'/pages/photo_confirm_user/photo_confirm_user',//小程序路径
	extraData: {
		type:'confirm_register_photo',// 家长确认学生重采照片场景
		user_name: '张三',   // 刷脸用户姓名，学生名字
		school_name:'深圳中学', // 学校
		user_type:'STAFF', //职业(STUDENT：学生,STAFF：职员)
		organization_id: 'O1947FD2089aed8785', // 机构ID
		out_user_id: '516064415', // 商户的用户ID
		account:'15988866666', //签约手机号
		token:'XCXab19673d0d0b5c0ffd980fb60ce82f5e'
	},
	envVersion: 'trial',    // 如果要跳转体验版，加上这个参数，否则请不要加这个参数
	success(res) {
		// 成功跳转到小程序确认流程
	},
	fail(res) {
		// 未成功跳转到小程序确认流程
	}
})

referrerInfo字段说明 {
	appId:'wx5931af4836330935', // 商户小程序appID
	extraData:{
		'return_code':'SUCCESS',
		'return_msg':'确认成功',
	}
}

//IWxPayfaceCallback//继承⾃AIDL接⼝，⽅便服务商使⽤。⽬前仅提⼀个统⼀的回调接⼝。
public abstract interface IWxPayfaceCallback {
	public abstract void response(Map info) throws RemoteException;
}

public void initWxpayface(Context ctx,Map info, IWxPayfaceCallback callback);

private void initPayFace() {
	Map<String, String> m1 = new HashMap<>();
	m1.put("ip", "xxx.xxx.xxx.xxx");
//若没有代理,则不需要此行,代理ip请自行寻找
	m1.put("port", "8888");
//若没有代理,则不需要此行，代理端口不一定是8888，根据代理设置来决定
	WxPayFace.getInstance().initWxpayface(this, m1, new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return ;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			Log.d(TAG, "response info :: " + code + " | " + msg);
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息: " + msg).printStackTrace();
				return ;
			}
			Log.d(TAG, "调用返回成功");
			/*
			在这里处理您自己的业务逻辑
			*/
		}
	});
}

public void getWxpayfaceRawdata(IWxPayfaceCallback callback);

private void getWxpayfaceRawdata() {
	WxPayFace.getInstance().getWxpayfaceRawdata(new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("returncode");
			String msg = (String) info.get("returnmsg");
			String rawdata = (String)info.get("rawdata");
			if (code == null || rawdata == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
			/*
			在这里处理您自己的业务逻辑
			*/
		}
	});
}

<return_code>SUCCESS</return_code>
<return_msg>请求成功</return_msg>
<nonce_str>Tivppi4UXAbgLxk8e1Sij76YdowOFFii</nonce_str>
<sign>PL0EUID6A7ICWNKHCSMQC0UIXOYNSE5B</sign>
<appid>wx31fdaErqR31</appid>
<mch_id>12345689</mch_id>
<authinfo>q3OPhFtQBf6KZGqmZhejKCRy5K/ch0kwS11YSsEj9XmUGqcsT2QPHt0Oa7xaCMCoSZTWMmShCo4dOiO5tU+OJEsvSxXzn5m3Nkh747tinNlbpJmVq1zOPj+FJNndkzanxoiAddO8p1EfrmUhJs/aNf0pDfrPoVfkAapK+ZY6blwyaDQ9bB7+KkZq29kObsXOZ3thg+bxP4RAqC0oxNS4JiyP0uA1Euzxtkc9lCTebloFied8stILrMehUKukeMGkZ1SzTyc8/HFHApzHahNPX6yD8ttzYnhe+IRMFJgpuTlIvEOYZUxenPXE1A5clrPvOBeJDszX/OvZl4fpYWPpXAcVQlw+gfYhblt+rT6ALMsD73w/rT4NRriQEEraC4Pfb5yua4qAqv4TVo04</authinfo>
<expires_in>3600</expires_in>

public void releaseWxpayface((Context cxt);

private void releasePayFace() {
	WxPayFace.getInstance().releaseWxpayface(this);
}

public void manualUpdateFaceDatas(Map info,IWxPayfaceCallback cb);

private void manualUpdateFaceDatas() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().manualUpdateFaceDatas(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
		}
	});
}
}

public void preloadSdkEnv(Map info,IWxPayfaceCallback cb);

private void preloadEnv() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().preloadSdkEnv(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || sdkVersion == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
			/*
			在这里处理您自己的业务逻辑
			*/
		}
	});
}

public void getSdkInfo(Map info,IWxPayfaceCallback cb);

private void getSdkInfo() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().getSdkInfo(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			String sdkVersion = (String)info.get("sdk_version");
			String faceFeatureVersion = (String)info.get("face_feature_version");
			int faceFeatureVersion = (Integer)info.get("user_info_dbcount");
			if (code == null || sdkVersion == null ||
			        !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
			/*
			在这里处理您自己的业务逻辑
			*/
		}
	});
}

public void getUserInfo(Map info,IWxPayfaceCallback cb);

private void getUserInfo() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().getUserInfo(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
			final String status = (String) info.get(FacePayConstants.KEY_RET_FACE_FEATURE_STATUS);
			final String syncTimeStr = (String) info.get(FacePayConstants.KEY_RET_USER_SYNCTIME);
			final String updateTimeStr = (String) info.get(FacePayConstants.KEY_RET_USER_UPDATETIME);
			String result = TextUtils.isEmpty(status) ? "用户不存在" : "用户当前状态:" + status;
		}
	});
}
}

public void setCameaPreview(SurfaceView surfaceView,Map info,IWxPayfaceCallback cb);

private void setCameaPreview(SurfaceView surfaceview) {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().setCameaPreview(surfaceview,params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
		}
	});
}
}

public void removeCameaPreview(SurfaceView surfaceView,Map info,IWxPayfaceCallback cb);

private void removeCameaPreview(SurfaceView surfaceview) { //params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().removeCameaPreview(surfaceview,params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
		}
	});
}
}

public void startVerify( Map info, IWxPayFaceCallbackAIDL cb);

public class UserInfo implements Parcelable {
	private String userId;
	private String outUserId;
	private String status;
	//用户状态，FS_NORMAL为正常，其余非法，不能扣款
	...
}

private void startVerify() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayface.getInstance().startVerify(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + "   ").printStackTrace();
				return ;
			}
			List<UserInfo> userInfos =(List<UserInfo>)info.get("user_info_list");
//是否需要辅助验证
			final Boolean needExtVerify = (Boolean) (info.get(FacePayConstants.KEY_RET_PARAMS_NEED_EXT_VERIFY));
			final Bitmap bitmap =(Bitmap)info.get("best_face_img");
			Handler handler = new Handler(Looper.getMainLooper());
			handler.post(new Runnable() {
				@Override
				public void run() {
					mImageView.setImageBitmap(bitmap);
					mImageView.requestLayout();
				}
			});
		}
	});
}

public void stopVerify(Map info,IWxPayfaceCallback cb);

private void stopVerify() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().stopVerify(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
		}
	});
}
}

public void finishFaceVerify(Map info,IWxPayfaceCallback cb);

private void finishFaceVerify() {
//params包含请求通用参数(authinfo,mchid等)
	WxPayFace.getInstance().finishFaceVerify(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("returncode");
			String msg = (String) info.get("returnmsg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,returnmsg:" + msg + " ").printStackTrace();
				return ;
			}
			UserInfo userInfo =(UserInfo)info.get("userinfo");
			if(userInfo == null || TextUtils.isEmpty(userInfo.getUserId()) {
			new RuntimeException("调用返回非成功信息,returnmsg: 用户信息为空").printStackTrace();
				return ;
			}
//到此处才算成功，一定要注意userinfo和userid判空
		});
	}
}
}
}

public void getFacePayCredential(Map info,IWxPayfaceCallback cb);

private void getFacePayCredential() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().getFacePayCredential(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			String faceToken= (String)info.get("face_token");
			if (code == null || !code.equals("SUCCESS") || TextUtils.isEmpty(faceToken)) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
//到此处才算成功，一定要注意faceToken判空
		}
	});
}
}

public void startCodeScanner(Map info,IWxPayfaceCallback cb);

WxPayFace.getInstance().startCodeScanner(params,new IWxPayfaceCallback() {
	@Override
	public void response(Map info) throws RemoteException {
		if (info != null) {
			String return_code = (String) info.get("return_code");
			Integer errcode = (Integer) info.get("err_code");
			String return_msg = (String) info.get("return_msg");
			String code_msg = (String) info.get("code_msg");
			final String resultString = "startCodeScanner, return_code : " + return_code + " return_msg : " + return_msg + " code_msg: " + code_msg;
			/** 这里添加业务自定义的工作即可 注意该回调在异步线程 **/
		}
	}
});

public void stopCodeScanner(Map info,IWxPayfaceCallback cb);

WxPayFace.getInstance().stopCodeScanner(params,,new IWxPayfaceCallback() {
	@Override
	public void response(Map info) throws RemoteException {
		if (info == null) {
			new RuntimeException("调用返回为空").printStackTrace();
			return;
		}
		String code = (String) info.get("return_code");
		String msg = (String) info.get("return_msg");
		if (code == null || !code.equals("SUCCESS")) {
			new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
			return ;
		}
	}
});

public void goToFactoryPage(Map info,IWxPayfaceCallback cb);

WxPayFace.getInstance().goToFactoryPage(params,new IWxPayfaceCallback() {
	@Override
	public void response(Map info) throws RemoteException {
		if (info == null) {
			new RuntimeException("调用返回为空").printStackTrace();
			return;
		}
		String code = (String) info.get("return_code");
		String msg = (String) info.get("return_msg");
		if (code == null || !code.equals("SUCCESS")) {
			new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
			return ;
		}
	}
});

public void clearFaceDatas(Map info,IWxPayfaceCallback cb);

private void clearFaceDatas() {
//params包含请求通用参数(authinfo,mch_id等)
	WxPayFace.getInstance().clearFaceDatas(params,new IWxPayfaceCallback() {
		@Override
		public void response(Map info) throws RemoteException {
			if (info == null) {
				new RuntimeException("调用返回为空").printStackTrace();
				return;
			}
			String code = (String) info.get("return_code");
			String msg = (String) info.get("return_msg");
			if (code == null || !code.equals("SUCCESS")) {
				new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
				return ;
			}
		}
	});
}
}

public void stopCamera(Map info,IWxPayfaceCallback cb);

private void stopCamera() {
//params包含请求通用参数(authinfo,mch_id等) WxPayFace.getInstance().stopCamera(params,new IWxPayfaceCallback() {
	@Override
	public void response(Map info) throws RemoteException {
		if (info == null) {
			new RuntimeException("调用返回为空").printStackTrace();
			return;
		}
		String code = (String) info.get("return_code");
		String msg = (String) info.get("return_msg");
		if (code == null || !code.equals("SUCCESS")) {
			new RuntimeException("调用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
			return ;
		}
	}
});
}
}

public void setLog(WxLog log);

private void setLog() {
	WxLog logImpl = new WxLog() {
		@Override
		public void d(String tag, String msg) {
//可使用服务商自己的日志输出
		}
		@Override
		public void i(String tag, String msg) {
//可使用服务商自己的日志输出
		}
		@Override
		public void e(String tag, String msg) {
//可使用服务商自己的日志输出
		}
		@Override
		public void e(String tag, String msg, Throwable e) {
//可使用服务商自己的日志输出
		}
	};
	WxPayFace.getInstance().setLog(logImpl);
}