客户APP跳转众趣VR的通用对接协议

iOS

跳转URL示例

openzhongquvr://?customer=zhongqukeji&enable=0&name=name&pswd=12345678&orderid=123456

参数	是否必须	说明	示例
openzhongquvr://	是	协议	openzhongquvr://
enable	是	跳转权限	1
customer	是	客户公司名称	zhongqukeji
name	见下方 enable权限与参数搭配	账号名称	name
pswd	见下方 enable权限与参数搭配	账号密码	3dnest
orderid	见下方 enable权限与参数搭配	订单id	123456

enable权限与参数搭配

enable权限	权限说明	name	pswd	orderid
0	仅唤起	可选	可选	可选
1	唤起+登录	必须	必须	可选
2	唤起+登录+订单项目创建	必须	必须	必须

客户APP配置

需要在工程的Info.plist文件中添加白名单：
LSApplicationQueriesSchemes(Array类型)，
添加一个Item(String类型)，
对应的值是openzhongquvr。

客户APP跳转示例代码

// 拼接跳转url字符串
NSString *urlString = @"openzhongquvr://?customer=zhongqukeji&enable=1&name=name&pswd=12345678&orderid=123456";
// 创建URL并跳转
NSURL *url = [NSURL URLWithString:urlString];
if ([[UIApplication sharedApplication] canOpenURL:url]) {
    [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {

    }];
}

Android

跳转到众趣VR APP的采用隐式跳转的方式。

跳转众趣VR APP代码示例：

try {
    //将协议文本解析成Uri
    Uri uri = Uri.parse("openzhongquapp://vr.zhongqu.com/?customer=zhongqukeji&enable=0&name=test&pswd=3dnest&orderid=1234");
    //定义Intent的action
    String action = "com.zhongqu.vr.launch";
    //使用action和uri构造一个Intent对象
    Intent intent = new Intent(action, uri);
    //使用Intent跳转众趣VR App
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    //如果没有安装众趣VR App，会捕获到ActivityNotFoundException异常，可以在这里进行请安装众趣VR的提示
}

协议参数说明：

参数	是否必须	含义	在Intent中的含义
com.zhongqu.vr.launch	是	代表跳转到众趣方App	Intent的action的值
openzhongquapp://vr.zhongqu.com/	是	代表跳转到众趣VR App	Intent的data(uri)的scheme://host/部分
enable	是	跳转到众趣VR之后希望执行的操作，可选值见下方【enable参数说明】表格，不传此参数默认操作为仅唤起	uri的query parameter
customer	是	客户公司名称	uri的query parameter
name	见下方 enable权限与参数搭配	登录众趣VR App使用的账号名称	uri的query parameter
pswd	见下方 enable权限与参数搭配	登录众趣VR App使用的账号密码	uri的query parameter
orderid	见下方 enable权限与参数搭配	订单id	uri的query parameter

enable权限与参数搭配

enable权限	权限说明	name	pswd	orderid
0	仅唤起	可选	可选	可选
1	唤起+登录	必须	必须	可选
2	唤起+登录+订单项目创建	必须	必须	必须