UC游戏_SDK_开发参考说明书_总体机制_v1.0.4

admin管理员组

文章数量:1530891

2024年7月12日发(作者：)

UC优视游戏SDK

开发参考说明书

—总体机制

2012-0

2012-04

4-1

-11

1

修订记录

修订记录

归档日期

2012-04-11

2012-05-08

2012-05-24

2012-06-15

2012-08-24

版本

1.0.0

1.0.1

1.0.2

1.0.3

1.0.4

初稿

补充充值机制

增加充值机制说明

修正4.3中错误的章节导航，“2.2”改为“4.2.1”。

4.2.2中增加对游戏老账号和相应的UC账号进行

绑定的说明。

说明作者审批人

1

目录

1.术语表...................................................................................................................................3

2.文档说明...............................................................................................................................4

3.概述.......................................................................................................................................5

4.总体机制说明.......................................................................................................................6

4.1.总体架构...........................................................................................................................6

4.2.登录机制...........................................................................................................................7

账号（ucid）登录........................................................................................7

4.2.2.游戏老账号登录...................................................................................................9

4.3.注册机制.........................................................................................................................11

4.4.充值机制.........................................................................................................................12

4.4.1.充值流程.............................................................................................................12

4.4.2.U点说明.............................................................................................................13

4.4.3.移动话费余额扣费说明.....................................................................................13

4.4.4.关于支付方式和支付通道.................................................................................14

4.4.5.关于充值订单提交和结果通知.........................................................................14

4.4.6.充值联调.............................................................................................................15

5.游戏接入步骤.....................................................................................................................16

2

1.

术语表

序号

1

2

3

术语名称

ucid

sid

cpid

术语说明

UC账号。用户在UC游戏中心的注册账号。

登录会话标识。

游戏合作厂商标识。由UC游戏中心分配，用于区别不同的游

戏合作厂商。

4

5

gameid

serverid

游戏标识。由UC游戏中心分配，用于区别具体的游戏。

游戏服务器标识，又称游戏分区标识。由UC游戏中心分配，

用于区别一款游戏中不同服务器或分区。

6apiKey签名密钥。由UC游戏中心为每个游戏合作厂商分配的消息签

名密钥，用于在双方系统数据传输过程进行数据签名时使用。

7游戏开发商开发具体游戏的组织。一般情况下，是与UC游戏中心合作的

游戏合作厂商。

8游戏SDKUC游戏中心开发的，为游戏开发商提供基础服务（登录、充

值等）的系统，包括“SDK客户端”和“SDK服务器”两部

分。

9

10

游戏客户端

游戏服务器

游戏开发商开发的，运行在用户终端上的软件。

游戏开发商开发的，配合“游戏客户端”为用户提供游戏服

务的服务器端程序。

3

2.

文档说明

《UC优视游戏SDK开发参考说明书》为游戏开发商的开发人员提供接入“游戏

SDK”的开发工作参考说明，共含7个分册：

1.《UC优视游戏SDK开发参考说明书-总体机制》

2.《UC优视游戏SDK开发参考说明书-IOSAPI》

3.《UC优视游戏SDK开发参考说明书-AndroidAPI》

4.《UC优视游戏SDK开发参考说明书-JavaAPI》

5.《UC优视游戏SDK开发参考说明书-服务器接口》

6.《UC优视游戏SDK开发参考说明书-IOSFAQ》

7.《UC优视游戏SDK开发参考说明书-AndroidFAQ》

4

3.

概述

UC游戏平台拥有强大的用户资源，对游戏投放、推广具有强大的优势。采用UC

成熟的账号体系对游戏开发商来说具有重要意义，可以实现一账号多游戏登录，免除用

户注册的麻烦并提高ucid的使用率；通过ucid打通UC账号服务体系，为游戏中植入

社区、支付等UC业务提供基础。

在游戏开发时集成本游戏SDK，即可使用UC的账号体系，不必去考虑用户登录、

充值等额外的开发工作，也不必顾虑账号、充值等相关的安全问题，专注于开发优质的

游戏，提高游戏的投放速度和效益。

本游戏SDK使用ucid在游戏客户端登录游戏，以及使用ucid在游戏客户端进行支

付。接入UC游戏平台涉及游戏开发的客户端和服务器端两部分：客户端部分主要实

现了用户登陆、注册和充值功能；服务器端部分主要包括了sid管理的接口。

5

机制说明

4.

总体总体机制说明

架构

4.1.总体总体架构

“游戏SDK”分为“SDK客户端”（集成于游戏中）、“SDK服务器”两部分。

“游戏客户端”（内含“SDK客户端”）、“游戏服务器”、“SDK服务器”之间的关系

如下图所示：

游戏客户端

游戏服务器

SDK

客户端

SDK

服务器

图4.1外部关系图（游戏SDK）

6

4.2.登录机制

4.2.1.

（

ucid

）登录

UC账号账号（ucid）登录

用户使用“UC账号”方式登录时，将采用增强的password方式，登录验证机制

和流程如下图所示：

游戏客户端

3.s

id

SDK

客户端

游戏服务器

7.登录结果、[

ucid

、用户昵称]

1.u

cid

、密码

gameid

、

cpid

2.s

id

eid

、

cpid

、

sid

6、

ucid

、用户昵称

SDK

服务器

图4.2.1“UC账号”登录过程

1.“游戏客户端”调用“SDK客户端”的登录功能，“SDK客户端”引导用户输入

用户名密码，当用户使用“UC账号”登录时，“SDK客户端”调用“SDK服务器”

接口进行身份验证；

2.“SDK服务器”密码验证通过后返回sid及用户相关信息（包括：ucid、用户昵

称等）；

3.“游戏客户端”在“SDK客户端”回调通知后，可向“SDK客户端”获取sid；

4.“游戏客户端”根据游戏的逻辑需要可将sid传给“游戏服务器”；

5.“游戏服务器”可向“SDK服务器”请求验证sid（调用用户会话验证接口，详

7

见《UC优视游戏SDK开发参考说明书-服务器接口》）；

6.“SDK服务器”将sid的验证结果和对应的ucid返回给“游戏服务器”；

7.“游戏服务器”将sid的验证结果及ucid、用户昵称返回给“游戏客户端”。

注：sid的有效时间为1小时，“游戏服务器”须在1小时内完成sid验证。

8

4.2.2.

老账号登录

游戏游戏老账号老账号登录

当用户采用“游戏老账号”（名称可能是“三国号”、“仙剑号”等，区别于UC账号

体系）登录时，登录验证机制和流程如下：

5.s

id

游戏客户端

1.游戏老帐号、密码

游戏服务器

SDK

客户端

4.登录验证结果、

sid

6.s

id

7.u

cid

、用户昵称、

sid

eid

、

cpid

游戏老帐号

3.u

cid

、

sid

、用户昵称

SDK

服务器

图4.2.2“游戏老账号”登录过程

1.“游戏客户端”调用“SDK客户端”登录功能，“SDK客户端”引导用户输入用

户名、密码，当用户使用“游戏老账号”登录时：

i.“SDK客户端”将游戏老账号和密码传给“游戏客户端”；

ii.“游戏客户端”将游戏老账号和密码提交“游戏服务器”进行验证；

2.“游戏服务器”验证通过后，调用“SDK服务器”接口(登录状态同步接口，参考

“服务器端接口说明”一节)，传递gameid、cpid、游戏老账号给“SDK服务器”，执

行该游戏账号在“SDK服务器”上的登录；

3.“SDK服务器”完成对应用户的登录后，返回该用户对应的ucid、用户身份标识

sid及用户昵称；

4.“游戏服务器”将用户登录验证结果，及对应的sid返回给“游戏客户端”；

5.“游戏客户端”将sid返回给“SDK客户端”，通知“SDK客户端”验证通过；

9

6.“SDK客户端”将sid发送到“SDK服务器”进行验证；

7.“SDK服务器”返回验证结果与用户信息（ucid、用户昵称）给“SDK客户端”，

完成用户的登录。

【注意】

【注意】：对于需要支持游戏老账号登录的游戏，“游戏服务器”需要

为ucid和游

戏老账号绑定映射关系，以能够同时兼容用户使用UC账号或游戏老账号登录，将其识

别为同一个用户。如果没有进行映射绑定，用户一次使用老账号登录，另一次使用UC

账号登录，则会被游戏识别为两个用户，严重影响用户体验。

“

游戏服务器

”

必须将游戏老账号与其对应的UC账号进行绑定映射，并此处要求此处要求“游戏服务器”

将这两个账号识别为同一个用户。

10

4.3.注册机制

新用户只支持注册UC账号，由“游戏SDK”完成注册过程，注册成功后，将自动

发起并完成游戏登录，登录过程同4.2.1节。

11

4.4.充值机制

4.4.1.

充值流程

游戏客户端

1.充值信息

SDK

客户端

4.订单号

5.订单号游戏服务器

2.s

id

、

gameid

、

Serverid、充值信息

3.订单号

6.订单号、

充值结果（异步）

CCESS

/

FAILURE

SDK

服务器

图4.4充值流程图

1.“游戏客户端”调用“SDK客户端”API接口，提交充值信息；

“SDK客户端”引导用户选择不同的充值方式，输入充值金额。

2.“SDK客户端”将sid、gameid、serverid以及对应的充值信息提交给“SDK

服务器”；

3.“SDK服务器”接收充值请求后，将返回对应“订单号”给“SDK客户端”；

4.“SDK客户端”将回调通知“游戏客户端”对应的充值“订单号”；

5.“游戏客户端”将接收到的“订单号”及相关的游戏角色信息（由游戏自行决定）

提交给“游戏服务器”；

6.“SDK服务器”在处理完充值请求后，将通过异步方式通知“游戏服务器”充值

结果。

7.“游戏服务器”向“SDK服务器”返回是否成功接收充值结果的标志（SUCCESS

12

或FAILURE）。充值结果的成功或失败与此处的接收标志无关，不论充值是否成功，只

要“游戏服务器”能够接收并识别充值结果通知，都应该向”SDK服务器“返回成功标

志（SUCCESS）。

4.4.2.U点说明

U点是UC提供的手机用户用于购买各种付费业务的一种虚拟货币，目前主要用于

支付UC运营的游戏、浏览器皮肤、音乐、手机主题、UC乐园游戏、手机小说等业务。

U点能提供方便快捷的、安全的手机小额支付体验，会通过不定期的打折和优惠券赠送

等营销活动为用户带来更多的实惠，同时还提供免费的消费短信提醒，让用户明白消费。

只要有UC账号，就可以对U点账户进行充值和使用U点进行消费。

使用U点余额为游戏充值具有方便快捷的特点，即时到账、灵活，不受面额局限，

很适合于作为对游戏进行充值的中间货币。只要用户在U点账户有余额，就随时可以使

用U点购买游戏的虚拟货币或道具，不需通过第三方支付网关，安全快速。

U点账户充值的方式目前有：支付宝、移动/联通充值卡、手机短信、固定电话、网

银等，登录U点充值页面可完成对U点账户进行充值。

U点账户充值和操作只能在UC浏览器里进行，登录方式有两种：

（1）登录UC用户中心（）-U点；

（2）直接登录。

4.4.3.移动话费余额扣费说明

移动话费扣款充值需要cmwap网络连接方式，对于非cmwap网络，无法成功进

行移动话费扣款。只有在cmwap网络连接时，才会出现移动话费扣款充值方式。

13

移动话费计费通道的消费上限从2012年5月23日凌晨4时之后由每月100元调

整为每月300元。

4.4.4.关于支付方式和支付通道

调用充值API时，SDK自动获取受支持的支付方式和支付通道，引导用户进行充值。

支付方式/通道包括：手机充值卡类、游戏点卡类、移动话费扣款充值、U点余额充值

等。随着业务发展，会产生新的支付方式和通道，开发游戏时，应能支持以上方式和通

道，但不应局限于以上方式，能兼容扩展的支付方式和通道。

4.4.5.关于充值订单提交和结果通知

使用充值卡充值涉及到多方的支付平台，充值结果不能实时获得，有时会有相当时

间的延迟才能收到充值结果。因而整个充值是一个两段的过程：①充值提交提交，状态

有“成功”和“失败”，成功则生成充值订单，并将订单号返回给游戏；②通过第三方

支付平台进行实际支付，此时也有“成功”和“失败”状态，“成功”意味着充值卡扣

费完成。

充值订单提交的“成功”并不意味着充值卡扣费的最终完成，有许多因素会造成充

值卡扣费的失败，如：卡已使用过、同一充值卡使用过于频繁、支付联网故障等。充值

订单提交后，游戏服务器通过“充值结果回调接口”收到充值结果通知的“成功”消息

后，才标志着充值的真正完成。

如果充值订单提交后未能及时收到充值结果通知，应耐心等待，也可以通过客服人

员追查充值情况。此时用户如果反复使用同一张卡提交充值订单，反而会造成充值的失

败。

14

由于支付网关的通知机制原因，偶尔会发生通知支付失败后又通知支付成功的现象。

基于这个情况，“游戏服务器”在处理充值结果通知时，对同一个订单，如果先接收到

支付失败，再接收到支付成功的通知，应以成功的支付结果为准，替换原接收到的失败

的支付结果。一旦通知支付成功，不会再发生通知支付失败的情形。

4.4.6.

充值联调

（1）测试环境联调

在测试环境联调时（isDebug=true/YES或setDebugMode(true)），输入的充

值卡并不要求是有效的充值卡，只需符合相应充值卡卡号和密码的规则即可。

可使用已经充完值的废卡进行测试。以下是几张可以进行测试的卡号和密码：

序号

1

2

3

4

5

6

7

8

充值卡类型

移动卡

移动卡

移动卡

移动卡

联通卡

联通卡

骏卡

骏卡

卡号

424896

18581

14567

18261

111

591

1123

1128

密码

3536861

466429

478686

443719

1129761

5960202

7626

8545786310102713

面额

50元

50元

50元

50元

100元

30元

10元

10元

（

2

）生产环境联测

在生产环境联测时（

isDebug=false/NO

或

setDebugMode(false)

），需使用真

实有效的充值卡进行测试，可购买小面额的充值卡用于测试。

15

5.

游戏接入步骤

“游戏开发商”将游戏接入UC游戏平台的过程如下：

16

本文标签： 游戏充值用户账号支付