7c云网络验证平台文档

# c++ 接入

7c云网络验证提供了c++对接，方便 c++ 开发者接入。

# 接入须知

# 对接视频

c++对接视频 (opens new window)

# 获取方式

下载地址: 或者加群675107742在群文件下载SDK，有问题也可在此群交流。

# 使用方式

先将下载到的c++ QCYSDK.rar文件解压出来，双击QCYSDK.sln选择VisualStudio 2022打开 压缩包中包含卡密登录例子，和用户登录例子。

# 卡密登录例子

#include "QCYSDK.h"

//appKey 在你的7c云开发后台软件管理里面获取
const string appKey = "";
//appSecret 在你的7c云开发后台软件管理里面获取
const string appSecret = "";
const bool isLoginAgain = true;//开启断线重连
const bool autoHeartbeat = true;//开启心跳
QCYSDK qcysdk(appKey, appSecret, isLoginAgain, autoHeartbeat);

int main() {
	qcysdk.token_path = "token.txt";//设备保存登录凭证token的路径
	qcysdk.SetCard("");//设置使用的卡密
	qcysdk.CardLogout();//退出上次的登录
	Resp resp = qcysdk.CardLogin();//卡密登录
	if (resp.code == 0) {
		cout << "登录成功" << endl;
		cout << "到期时间:" << resp.result.expires << endl;
		//**************下面开始你的代码*********************
		
	}
	else {
		cout << "登录失败:" << resp.message << endl;
	}
	return 0;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# 用户登录例子

#include "QCYSDK.h"

//appKey 在你7c云开发后台软件管理里面获取
const string appKey = "";
//appSecret 在你的7c云开发后台软件管理里面获取
const string appSecret = "";
const bool isLoginAgain = true;//开启断线重连
const bool autoHeartbeat = true;//开启心跳
QCYSDK qcysdk(appKey, appSecret, isLoginAgain, autoHeartbeat);

int main() {
	qcysdk.token_path = "token.txt";//设备保存登录凭证token的路径
	qcysdk.SetUser("", "");//填写用户名和密码
	qcysdk.UserLogout();//退出上次的登录
	Resp resp = qcysdk.UserLogin();//卡密登录
	if (resp.code == 0) {
		cout << "登录成功" << endl;
		cout << "到期时间:" << resp.result.expires << endl;
		//**************下面开始你的代码*********************
		
	}
	else {
		cout << "登录失败:" << resp.message << endl;
	}
	return 0;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# 初始化

# 初始化SDK

# 语法

QCYSDK qcysdk(appKey, appSecret, isLoginAgain, autoHeartbeat);
1

# 参数

参数名 必传 类型 参数说明
appKey 是 string 软件的appKey
appSecret 是 string 软件的appSecret
autoHeartbeat 是 boolean true开启心跳,false关闭心跳
isLoginAgain 是 boolean true开启断线重登,false关闭断线重登

# 卡密登录

注意

调用此接口前需调用 qcysdk.SetCard(card) 初始化卡密 登录成功后将自动启动一个线程发送心跳包，开发者就无需关注发送心跳包的细节。

# 语法

qcysdk.SetCard(card);
Resp resp = qcysdk.CardLogin();
cout << "code=" << resp.code << " message=" << resp.message << endl;
cout << "cardType=" << resp.result.cardType << endl;
cout << "token=" << resp.result.token << endl;
cout << "expires=" << resp.result.expires << endl;
cout << "expires_ts=" << resp.result.expires_ts << endl;
cout << "config=" << resp.result.config << endl;
cout << "server_time=" << resp.result.server_time << endl;
1
2
3
4
5
6
7
8
9

# 参数

无

# 返回值

Resp结构体类型，例：{ result: { cardType: '月卡', token: '8wr17hGcTs5lVVJ0liL97d6McNEaDTKk', expires: '2021-09-17 01:49:38', expires_ts: 1631814578, config: '', server_time: 1624110506 }, message: 'ok', code: 0 }

# 卡密退出登录

# 语法

Resp resp = qcysdk.CardLogout();
cout << "code=" << resp.code << " message=" << resp.message << endl;
1
2

# 参数

无

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 卡密解绑设备

注意

请先进入开发者后台软件管理页面，配置软件开启设备绑定且可解除绑定。

# 语法

Resp resp = qcysdk.CardUnbindDevice();
cout << "code=" << resp.code << " message=" << resp.message << endl;
1
2

# 参数

无

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 卡密绑定设备上解绑

注意

请先进入开发者后台软件管理页面，配置软件开启设备绑定且可解除绑定。

# 语法

Resp resp = qcysdk.CardUnbindDeviceBybindDevice();
cout << "code=" << resp.code << " message=" << resp.message << endl;
1
2

# 参数

无

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 卡密设置解绑密码

说明

请先进入开发者后台软件管理页面，配置软件开启设备绑定且可解除绑定。 该密码用于绑定设备丢失或者其它原因导致无法在老设备登录时解绑设备。

# 语法

Resp res = qcysdk.SetCardUnbindPassword(password);
1

# 参数

参数名 必传 类型 参数说明
password 是 string 解绑密码（6-10位数字和字母组合的字符串）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 卡密通过密码解绑设备

说明

请先进入开发者后台软件管理页面，配置软件开启设备绑定且可解除绑定。 该接口用于绑定设备丢失或者其它原因导致无法在老设备登录时，通过解绑密码解绑设备。

# 语法

Resp resp = qcysdk.CardUnbindDeviceByPassword(password);
1
参数名 必传 类型 参数说明
password 是 string 解绑密码（6-10位数字和字母组合的字符串）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 卡密充值（以卡充卡）

# 语法

Resp resp = qcysdk.CardRecharge(card, useCard);
1

# 参数

参数名 必传 类型 参数说明
card 是 string 被充值的卡密（长度不超过45位）
useCard 是 string 充值使用的卡密（长度不超过45位）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 用户注册（通过卡密）

# 语法

Resp res = qcysdk.UserRegister(username, password, card);
1

# 参数

参数名 必传 类型 参数说明
username 是 string 用户名（长度不能超过20位）
password 是 string 用户密码（长度6-30位）
card 是 string 注册使用的卡密（长度不超过45位）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "ok"}

# 用户登录

注意

调用此接口前需调用 qcysdk.SetUser(username, password) 初始化用户账号密码 登录成功后将自动启动一个线程发送心跳包，开发者就无需关注发送心跳包的细节。

# 语法

qcysdk.SetUser(username, password);
Resp resp = qcysdk.UserLogin();
cout << "code=" << resp.code << " message=" << resp.message << endl;
cout << "cardType=" << resp.result.cardType << endl;
cout << "token=" << resp.result.token << endl;
cout << "expires=" << resp.result.expires << endl;
cout << "expires_ts=" << resp.result.expires_ts << endl;
cout << "config=" << resp.result.config << endl;
cout << "server_time=" << resp.result.server_time << endl;
1
2
3
4
5
6
7
8
9

# 参数

无

# 返回值

Resp结构体类型，例：{ result: { cardType: '月卡', token: '8wr17hGcTs5lVVJ0liL97d6McNEaDTKk', expires: '2021-09-17 01:49:38', expires_ts: 1631814578, config: '', server_time: 1624110506 }, message: 'ok', code: 0 }

# 用户退出登录

# 语法

Resp resp = qcysdk.UserLogout();
1

# 参数

无

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 用户修改密码

# 语法

Resp resp = qcysdk.UserChangePassword(username, password, newPassword);
1

# 参数

参数名 必传 类型 参数说明
username 是 string 用户名（长度不能超过20位）
password 是 string 用户密码（长度6-30位）
newPassword 是 string 新密码（长度6-30位）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 用户充值（通过卡密）

# 语法

Resp resp = qcysdk.UserRecharge(username, card);
1

# 参数

参数名 必传 类型 参数说明
username 是 string 用户名（长度不能超过20位）
card 是 string 充值使用的卡密（长度不超过45位）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 用户解绑设备

# 语法

Resp resp = qcysdk.UserUnbindDevice();
1

# 参数

无

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 试用登录

注意

登录成功后将自动启动一个线程发送心跳包，开发者就无需关注发送心跳包的细节。

# 语法

Resp resp = qcysdk.TrialLogin();
1

# 参数

无

# 返回值

Resp结构体类型

# 获取卡密配置

# 语法

Resp resp = qcysdk.GetCardConfig();
1

# 参数

无

# 返回值

Resp结构体类型，例：{ result: { config: '', server_time: 1624120946 }, message: 'ok', code: 0 }

# 更改卡密配置

# 语法

Resp resp = qcysdk.UpdateCardConfig(config);
1

# 参数

参数名 必传 类型 参数说明
config 是 string 自定义配置（长度不能超过512位）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 获取用户配置

# 语法

Resp resp = qcysdk.GetUserConfig();
1

# 参数

无

# 返回值

Resp结构体类型，例：{ result: { config: '迪迦', server_time: 1624121563 }, message: 'ok', code: 0 }

# 更改用户配置

# 语法

Resp resp = qcysdk.UpdateUserConfig(config);
1

# 参数

参数名 必传 类型 参数说明
config 是 string 自定义配置（长度不能超过512位）

# 返回值

Resp结构体类型，例：{"code": 0, "message": "OK"}

# 获取软件配置

# 语法

Resp resp = qcysdk.GetSoftwareConfig();
1

# 参数

无

# 返回值

Resp结构体类型，例：{ result: { config: '迪迦', server_time: 1624121758 }, message: 'ok', code: 0 }

# 获取软件公告

# 语法

Resp resp = qcysdk.GetSoftwareNotice();
1

# 参数

无

# 返回值

Resp结构体类型，例：{ result: { server_time: 1624121862, notice: '泰罗' }, message: 'ok', code: 0 }

# 获取软件版本号和下载链接

# 语法

Resp resp = qcysdk.GetSoftwareVersion();
1

# 参数

无

# 返回值

Resp结构体类型，例：{ result: { server_time: 1624121862, version: '1.0.1', url:'www.baidu.com' }, message: 'ok', code: 0 }

# 获取远程变量

注意

调用此接口前 需要登录成功后才能调用。

# 语法

Resp resp = qcysdk.GetRemoteVar(key);
1

# 参数

参数名 必传 类型 参数说明
key 是 string 远程变量名（长度不能超过64位）

# 返回值

Resp结构体类型，例：{ result: { server_time: 1624122124, varValue: '斯奥特曼' }, message: 'ok', code: 0 }

# 获取远程数据

注意

调用此接口前 需要登录成功后才能调用。

# 语法

Resp resp = qcysdk.GetRemoteData(key);
1

# 参数

参数名 必传 类型 参数说明
key 是 string 远程数据key（长度不能超过64位）

# 返回值

Resp结构体类型，例：{ result: { server_time: 1624122295, value: '奥特曼' }, message: 'ok', code: 0 }

# 操作远程数据

# 新增远程数据

注意

调用此接口前 需要登录成功后才能调用。

# 语法

Resp resp = qcysdk.CreateRemoteData(key, value);
1

# 参数

参数名 必传 类型 参数说明
key 是 string 远程数据key（长度不能超过64位）
value 是 string 远程数据值（长度不能超过256位）

# 返回值

Resp结构体类型，例：{ result: { server_time: 1624122453 }, message: 'ok', code: 0 }

# 修改远程数据

注意

调用此接口前 需要登录成功后才能调用。

# 语法

Resp resp = qcysdk.UpdateRemoteData(key, value);
1

# 参数

参数名 必传 类型 参数说明
key 是 string 远程数据key（长度不能超过64位）
value 是 string 远程数据值（长度不能超过256位）

# 返回值

Resp结构体类型，例：{ result: { server_time: 1624122453 }, message: 'ok', code: 0 }

# 删除远程数据

注意

调用此接口前 需要登录成功后才能调用。

# 语法

Resp resp = qcysdk.DeleteRemoteData(key);
1

# 参数

参数名 必传 类型 参数说明
key 是 string 远程数据key（长度不能超过64位）

# 返回值

Resp结构体类型，例：{ result: { server_time: 1624122453 }, message: 'ok', code: 0 }

# 云函数

注意

调用此接口前 需要登录成功后才能调用。

# 语法

Resp resp = qcysdk.CallRemoteFn(fnName, params);
1

# 参数

参数名 必传 类型 参数说明
fnName 是 string 云函数名（长度不能超过64位）
params 是 string 调用云函数时传入的参数

# 返回值

Resp结构体类型，例：{"result":{"return":"55","server_time":1689788200},"message":"ok","sign":"236cd75d551fb991ac88684761778a17","nonce":"vwWSKfwOgbLocFzg15OX","code":0}

例子:

Resp resp = qcysdk.CallRemoteFn("add", "21, 34");
if (resp.code == 0)
{
  cout << "云函数调用结果:" << resp.result.returnValue << endl;
}
else
{
  cout << "云函数调用失败:" << resp.message << endl;
}
1
2
3
4
5
6
7
8
9

← Android Java 接入 →