INCESOFT机器人平台SDK程序员指南.doc

INCESOFT机器人平台WEB机器人使用指南目录 INCESOFT机器人平台WEB机器人使用指南目录 1 目录 2 1 获取帮助 3 1.1 客服支持 3 1.2 论坛支持 3 2 架构概览 4 3 关键特性 5 3.1 兼容MSN机器人SDK 5 3.2 支持头像、图释、闪屏等MSN特有特性 5 3.3 支持WEB机器人默认表现层配色方案的定制 5 3.4 支持WEB机器人表现层的自主开发 5 3.5 支持会话持有期间的主动下发消息 5 3.6 跨浏览器支持 5 3.7 国际化支持 5 3.8 消息内容支持UBB代码 5 4 实现流程 6 4.1 直接引用 6 4.2 嵌入引用 6 4.3 定制配色方案 7 5 表现层自主实现 9 5.1 Script API 9 5.2 最小实现 11 6 UBB语法说明 13  获取帮助 客服支持 您可以通过联系我们的客服人员来获得直接的产品或技术支持 客服电话 86-21 E-MAIL xiaoisupport@ MSN xiaoisupport@ QQ/TM 404539607 联系地址 中国上海市天山西路799号3楼 邮政编码 200335 论坛支持 您可以在我们开发者论坛的相应版块提出您的疑问，我们的相关人员会在短时间内对您的问题做出反馈。论坛地址： 架构概览 INCESOFT机器人平台的网络架构，如图１所示，服务商、和之间的关系是比较简单，服务商的Server通过与Server相连提供服务。而通过，就能享受服务商提供的服务。… 消息内容支持UBB代码 参见 6 UBB语法说明 实现流程 直接引用 引用地址：:8100/engine/{SPID}/webbot.htm 引用地址中 {SPID}为用户在Incesoft申请的服务提供商标识 方式一：SP可通过链接引导用户直接访问此页面 a href=” :8100/engine/{SPID}/webbot.htm”/a 方式二：SP可通过iframe嵌入自己页面 iframe src=” :8100/engine/{SPID}/webbot.htm”/iframe 方式三：SP可通过弹出窗口形式展现 window.open(“:8100/engine/{SPID}/webbot.htm”); 嵌入引用 引用地址：:8100/engine/{SPID}/embedbot.js 引用地址中 {SPID}为用户在Incesoft申请的服务提供商标识 SP可以将此js远程包含进自己页面的body部分，webbot就会浮动于页面上。 html head…/head body …... …… script type=”text/javascript” src=” :8100/engine/{SPID}/embedbot.js”/script /body /html 定制配色方案 在引用webbot的地址时，SP可以将配色方案通过url参数的形式传给webbot。 参数：panel_color ------ 面板颜色 line_color -------- 线条和字体颜色 body_color ------ 背景颜色 参数值为16进制颜色值，为6字符长，比如 红色：FF0000，蓝色：0000FF 例： :8100/engine/{SPID}/webbot.htm?body_color=FCF5F8panel_color=FAEBF1line_color=A04F6B :8100/engine/{SPID}/embedbot.js?body_color=FCF5F8panel_color=FAEBF1line_color=A04F6B 表现层自主实现 若SP对默认的表现层实现不满意，可以自主开发表现层，以配合自己的网页。 自定义开发表现层需要通过javascript远程引入开发接口。 接口地址：:8100/engine/{SPID}/webbot.js 引入方式： script type=”text/javascript” src=” :8100/engine/{SPID}/webbot.js”/script Script API 对象 Conversation： 此对象包装了web机器人的所有操作。此对象必须在自主开发的机器人页面的顶层实例化，且仅能实例化一次。 方法:InitializeTranscriptDiv(transcriptDiv) 此方法初始化聊天消息显示区块。此区块中将用来显示由SDK下发的机器人消息。开发规定此区块必须存在于web机器人的某个iframe页面。 方法: InitializeDisplayPictureDiv(dpDiv) 此方法初始化头像