中国移动scp和ip之间uiscript协议规范.docx

1、中国移动scp和ip之间uiscript协议规范中国移动通信企业标准中国移动通信集团公司 发布-实施-发布QB-SCP和IP之间UISCRIPT协议规范征求意见稿版本号：1.1.0 目次前言 21 范围 12 引用标准 13 术语和定义 14 符号和缩略语 15 概述 26 UISCRIPT的功能 27 UISCRIPT的机制 28 UISCRIPT对脚本的要求 38.1 脚本的要求 38.2 脚本的描述方式 39 UISCRIPT操作 39.1 综述 39.2 ScriptRun 49.2.1 操作描述 49.2.2 参数结构 49.2.3 编码规则 59.3 ScriptInformati

2、on 69.3.1 操作描述 69.3.2 参数结构 69.3.3 编码规则 79.4 ScriptEvent 89.4.1 操作描述 89.4.2 参数结构 89.4.3 编码规则 99.5 ScriptClose 109.5.2 参数结构 109.5.3 编码规则 109.6 UIScriptSpecificInformation/UIScriptResult的定义 119.6.1 SCRIPTRUN操作中的UIScriptSpecificInformation定义 129.6.2 SCRIPTEVENT操作中的uIScriptResult定义 129.6.3 SCRIPTINFO操作中的

3、UIScriptSpecificInformation定义 159.6.3 SCRIPTCLOSE操作中的UIScriptSpecificInformation定义 159.7 UIScriptID的定义 16附件：编制历史 17前言随着基于内容业务的不断发展和梦网模式的不断普及，移动用户对内容的需求也逐步增大。目前，运营商主要通过数据业务（短消息、GPRS等）向用户提供内容。话音内容服务系统是通过话音为主的方式向用户提供内容服务。该系统由SCP（语音网关）、增强IP、SP等几个部分组成。本规范主要对SCP（语音网关）和增强IP之间的接口进行描述和定义。本标准由中国移动通信集团公司技术部提出并

4、归口。本标准由标准提出并归口部门负责解释。本标准起草单位：中国移动通信集团公司研发中心。本标准主要起草人：魏冰、赵毓毅。1 范围本标准主要对话音内容服务系统中的SCP（语音网关）和增强IP设备之间的接口进行了规范。本标准适用于SCP（语音网关）和增强IP设备之间接口的研制、开发、测试。2 引用标准本标准引用了以下标准或规范：1 话音内容服务业务总体技术要求2 Q.12283 术语和定义UI-SCRIPT CS2中定义的脚本形式，用于SCP对IP上脚本的调用NO.7 7号信息定购 指用户选择业务的过程4 符号和缩略语IVR 交互式语音应答系统SCP 业务控制点IP 智能外设SSP 业务交换点SC

5、E 业务生成环境CAP CAMEL应用部分API 应用编程接口XML 可扩展标识语言VXML 语音可扩展标识语言DSMP 数据业务管理平台5 概述UIScript（User Interaction Script）接口是在CS2中定义的一种用于SCF与SRF之间标准INAP信令，包括四种主要操作原语ScriptRun、ScriptInformation、ScriptEvent、ScriptClose，分别在一次完整的SCF/SRF交互过程的不同阶段应用。独立IP作为一种重要的智能外设在智能网中执行SRF的职能，在SCP与IP的交互中使用UIscript机制不仅可以有效减少大量PA和P&C操作，减

6、轻信令交互的负担，同时也可以将一部分业务逻辑功能从SCP转移到独立IP执行，使业务分别更加合理。在话音内容服务系统中，UIScript接口主要用于SCP和增强IP之间的交互。6 UISCRIPT的功能6.1 智能业务处理的负荷得到了分担：智能网中的业务的控制在分布平面上进行了划分，在某些业务中SCF负责业务中路由，计费部分的控制，而SRF负责业务中用户交互部分的控制。6.2 用户交互控制在业务间得到共享：一些有意义的用户交互过程可以被不同的业务使用。6.3 提高用户交互的响应速度：和用户交互过程中SCF与SRF的交互减少，缩短了用户交互处理的时间。6.4 提供了一种向第三方开发业务逻辑修改、编

7、写的方式。使得第三方可以控制IP上的业务逻辑。7 UISCRIPT的机制SCP和增强IP之间对话的建立方式：标准的CAMEL方式；SCP和增强IP之间对话的结束方式：SCP通过TC-END结束对话，或者增强IP在脚本运行完毕出于空闲状态时通过TC-END结束对话；UISCRIPT操作以脚本ID为标识，组成一组相关操作；每组相关操作必须以RUN操作开始；SCP可以主动向增强IP发送RUN、INFO、CLOSE等操作；增强IP可以向SCP发送EVENT操作，SCP需要按照顺序以INFO或者CLOSE操作反馈。脚本有两种结束方式：隐式结束和显式结束；隐式结束中，当UIScript脚本结束后，增强IP

8、会主动结束脚本，释放脚本资源；显式结束中，当UIScript脚本结束后，SRF保持在“User Interation”状态，即不结束脚本，等待SCF发送uIScriptClose操作来通知IP结束脚本，释放脚本资源。一旦发送了CLOSE操作，所有和该CLOSE操作包含的脚本ID相同的操作全部失效。8 UISCRIPT对脚本的要求8.1 脚本的要求对脚本的描述方式主要需要考虑的有这么几点： 脚本的执行效率； 脚本描述的方便性； 脚本能力的可扩展性； 脚本描述方式的标准性；8.2 脚本的描述方式对脚本的描述方式主要可以有这么几种： 面向过程的描述语言来描述； 面向对象的描述语言来描述； 标记语言来

9、描述；在话音内容服务业务中，我们建议采用VXML作为脚本描述语言，具体的规范参见VXML规范的要求。9 UISCRIPT操作9.1 综述根据INAP CS2 Q.1228中的描述，UISCRIPT的各个操作属于INAP层，由TCAP承载，适用于SCP和SRP之间的交互。UIScript是SLP视角中的SRF资源功能，SLP通过SCF向SRF申请UIScript的执行。UIScript描述了对SRF各个资源基本功能的、以有逻辑方式组合的使用过程。对应于一个呼叫，某个UIScript会被激活执行，这样的一个执行称为一个UIScript实例。增强的SRF是UIScript执行的场所，它能够根据对基本

10、资源功能的某种组合的描述（UIScript），有逻辑地激活不同的资源功能。通过这种方法，SRF除了提供基本的资源功能服务外，还提供组合的资源功能服务（UIScript），因此表现出服务的多样性和灵活性。UIScript包括以下4个操作：ScriptRun（SCF-SRF）：用于激活脚本，占用资源；参数有UIScriptId, UIScriptSpecificInformation, callSegmentIdentifier, disconnectFromIPForbidden；ScriptEvent（SRF-SCF）：用于传递脚本执行结果；参数有UIScriptId, UIScriptSpe

11、cificInformation, callSegmentIdentifier, lastEventIndicator；ScriptInformation（SCF-SRF）：用于向脚本传递参数；参数有UIScriptId, UIScriptSpecificInformation, callSegmentIdentifier；ScriptClose（SCF-SRF）：用于关闭脚本，释放资源；参数有UIScriptId, UIScriptSpecificInformation, callSegmentIdentifier；9.2 ScriptRun9.2.1 操作描述方向：SCF 增强IP功能：此

12、操作用于分配执行用户交互脚本实例所必需的资源，并且激活该脚本实例。9.2.2 参数结构scriptRun PARAMETERS-BOUND : bound OPERATION := ARGUMENT ScriptRunArg bound RETURN RESULT FALSE ERRORS systemFailure | missingParameter | taskRefused | unavailableResource | unexpectedComponentSequence | unexpectedDataValue | unexpectedParameter CODE opcode

13、-scriptRun ScriptRunArg PARAMETERS-BOUND : bound := SEQUENCE uIScriptId UISCRIPT.&id(SupportedUIScripts bound), uIScriptSpecificInfo 0 UISCRIPT.&SpecificInfo(SupportedUIScripts bounduIScriptId) OPTIONAL, extensions 1 SEQUENCE SIZE (1.bound.&numOfExtensions) OF ExtensionField bound OPTIONAL, disconne

14、ctFromIPForbidden 2 BOOLEAN DEFAULT TRUE, callSegmentID 3 CallSegmentID bound OPTIONAL, . 9.2.3 编码规则 ScriptRun操作标识: opcode-scriptRun Code := local : 110 uIScritpID用于唯一标识脚本；定义：uIScriptID := Integer4uIScriptID参数有4个字节，编码时按照号段分配给各业务使用，以避免各业务所使用的uIScriptID交叉。每一种业务中又可以根据脚本类型和适用流程再进行分段，分段规则可以固定长度分配，具体的规则参见

15、9.7节中的描述。 uIScriptSpecificInfo用于向IP发送被调用的脚本所需要的信息；定义：UIScriptSpecificInfo :=OCTET STRING (SIZE(127)编码：符合ASN OCTET STRING类型编码，内部采用ASN.1的编码方式，格式如下：“TAG长度值”。ASN.1只支持普通类基本数据类型编码方式，TAG的定义如下：类型TAGBOOLEAN0x01INTEGER0x02STRING0x04NULL0x05ENUMERATE0x0AuIScriptSpecificInfo中包含的各段参数中的第一个参数（METHODID）固定用于标识本次Scri

16、ptRun操作中uIScriptSpecificInfo参数组的含义。具体参见9.6节中的定义。 disconnectFromIPForbidden指示IP在脚本执行完后是否应该主动与用户（SSP）断开连接；定义：disconnectFromIPForbidden :=BOOLEAN编码：长度为一个字节，TRUE表示不允许IP自动拆线；FALSE表示允许IP自动拆线； extensions、callSegmentID可选参数，目前暂不使用；9.3 ScriptInformation9.3.1 操作描述方向：SCF 增强IP功能：此操作用于SCP在IP端脚本执行过程中IP发送附加信息，或者在收到

17、SCRIPTEVENT操作后反馈一定的信息。9.3.2 参数结构scriptInformation PARAMETERS-BOUND : bound OPERATION := ARGUMENT ScriptInformationArg bound RETURN RESULT FALSE ERRORS systemFailure |missingParameter |taskRefused |unavailableResource |unexpectedComponentSequence |unexpectedDataValue unexpectedParameter CODE opcode-s

18、criptInformation ScriptInformationArg PARAMETERS-BOUND : bound := SEQUENCE uIScriptId UISCRIPT.&id(SupportedUIScripts bound), uIScriptSpecificInfo 0 UISCRIPT.&SpecificInfo(SupportedUIScripts bounduIScriptId) OPTIONAL, extensions 1 SEQUENCE SIZE(0.bound.&numOfExtensions) OF ExtensionField bound OPTIO

19、NAL, callSegmentID 2 CallSegmentID bound OPTIONAL, . 9.3.3 编码规则 ScriptInformation操作标识: opcode-scriptInformation Code := local : 108 uIScritpID用于唯一标识脚本；定义：uIScriptID := Integer4具体编码方案与ScriptRun操作中的uIScriptID参数编码方案同。 uIScriptSpecificInfo用于向IP发送被调用的脚本所需要的信息；定义：uIScriptSpecificInfo :=OCTET STRING (SIZE(

20、127)编码：符合ASN OCTET STRING类型编码，内部采用ASN.1的编码方式，格式如下：“TAG长度值”ASN.1只支持普通类基本数据类型编码方式，TAG的定义如下：类型TAGBOOLEAN0x01INTEGER0x02STRING0x04NULL0x05ENUMERATE0x0AuIScriptSpecificInfo中包含的各段参数中的第一个参数（METHORID）固定用于标识本次ScriptInformation操作中uIScriptSpecificInfo参数组的含义。具体参见9.6节中的定义。 extensions、callSegmentID可选参数，目前暂不使用；9.4

21、 ScriptEvent9.4.1 操作描述方向：SRF（IIP） SCF功能：此操作用于IP向SCP返回脚本执行结果或收集到的信息。9.4.2 参数结构scriptEvent PARAMETERS-BOUND : bound OPERATION := ARGUMENT ScriptEventArg bound RETURN RESULT FALSE ALWAYS RESPONDS FALSE CODE opcode-scriptEvent ScriptEventArg PARAMETERS-BOUND : bound := SEQUENCE uIScriptId UISCRIPT.&id(S

22、upportedUIScripts bound), uIScriptResult 0 UISCRIPT.&Result(SupportedUIScripts bounduIScriptId) OPTIONAL, extensions 1 SEQUENCE SIZE (1.bound.&numOfExtensions) OF ExtensionField bound OPTIONAL, callSegmentID 2 CallSegmentID bound OPTIONAL, lastEventIndicator 3 BOOLEAN DEFAULT FALSE, . 9.4.3 编码规则 Scr

23、iptEvent操作标识: opcode-scriptEvent Code := local : 109 uIScritpID用于唯一标识脚本；定义：uIScriptID := Integer4具体编码方案与ScriptRun操作中的uIScriptID参数编码方案同。 uIScriptResult用于IP向SCP返回脚本执行结果；定义：uIScriptResult :=OCTET STRING (SIZE(127)编码：符合ASN OCTET STRING类型编码，内部采用ASN.1的编码方式，格式如下：“TAG长度值”ASN.1只支持普通类基本数据类型编码方式，TAG的定义如下：类型TAG

24、BOOLEAN0x01INTEGER0x02STRING0x04NULL0x05ENUMERATE0x0AuIScriptResult中包含的各段参数中的第一个参数（METHORID）固定用于标识本次ScriptEvent操作中uIScriptResult参数组的含义。具体参见9.6节中的定义。 lastEventIndicator此参数表明当前ScriptEvent中包含了本次Script脚本操作最终的结果，如果当前ScriptEvent是当前被调用脚本的最后一次返回结果，则此参数值必须设置为TRUE extensions、callSegmentID可选参数，目前暂不使用；9.5 Scrip

25、tClose9.5.1 操作描述方向：SCF SRF（IIP）功能：此操作用于释放调用脚本时分配的资源，结束本次脚本实例调用。9.5.2 参数结构scriptClose PARAMETERS-BOUND : bound OPERATION := ARGUMENT ScriptCloseArg bound RETURN RESULT FALSE ERRORS systemFailure | missingParameter | taskRefused | unavailableResource | unexpectedComponentSequence | unexpectedDataValue

26、 | unexpectedParameter CODE opcode-scriptClose ScriptCloseArg PARAMETERS-BOUND : bound := SEQUENCE uIScriptId UISCRIPT.&id(SupportedUIScripts bound), uIScriptSpecificInfo 0 UISCRIPT.&SpecificInfo(SupportedUIScripts bounduIScriptId) OPTIONAL, extensions 1 SEQUENCE SIZE (1.bound.&numOfExtensions) OF E

27、xtensionField bound OPTIONAL, callSegmentID 2 CallSegmentID bound OPTIONAL, . 9.5.3 编码规则 ScriptClose操作标识: opcode-scriptClose Code := local : 111 uIScritpID用于唯一标识脚本；定义：UIScriptID := Integer4具体编码方案与ScriptRun操作中的uIScriptID参数编码方案同。 uIScriptSpecificInfo用于向IP发送被调用的脚本所需要的信息；定义：uIScriptSpecificInfo :=OCTET

28、STRING (SIZE(127)编码：符合ASN OCTET STRING类型编码，内部采用ASN.1的编码方式，格式如下：“TAG长度值”ASN.1只支持普通类基本数据类型编码方式，TAG的定义如下：类型TAGBOOLEAN0x01INTEGER0x02STRING0x04NULL0x05ENUMERATE0x0AuIScriptSpecificInfo中包含的各段参数中的第一个参数（METHORID）固定用于标识本次ScriptClose操作中uIScriptSpecificInfo参数组的含义。具体参见9.6节中的定义。 extensions、callSegmentID可选参数，目前暂

29、不使用；9.6 UIScriptSpecificInformation/UIScriptResult的定义定义：uIScriptResult :=OCTET STRING (SIZE(0127)tag的类型包括INTEGER（2）、STRING（4）、NULL（5）、BOOLEAN（1）、ENUMERATE（A）；在SCP主控逻辑中，主要调用的是“注册脚本”和“分业务脚本”（如都市情缘，疯狂大拍卖，会议电话预约等），因此这里着重说明UIScriptSpecificInformation（SRP返回结果时为uIScriptResult参数）的定义。为了区分该参数组特定流程的含义，需要有METHODID来标识，参数组内其他参数按照字节数来截取（如果消息长度足够，也可以考虑ASN.1的TLV格式）。9.6.1 SCRIPTRUN操作中的UIScriptSpecificInformation定义参数名数据类型说明METHODIDINTEGER 4RUN操作中只有一种方式，取值为0主叫号码STRING 20接入该业务的主叫用户号码被叫号码STRING 20用户拨打的号码呼叫时长限制INTEGER 4