FAQ
1.如何引入Tida?
当前JSSDK不支持本地开发测试,必须要将工程发布到ews.cloud.tmall.com,才能在手淘环境里调用。引入tida.js【
<script src="//g.alicdn.com/tmapp/tida2/2.2.16/tida.js?appkey=应用的前台appkey">
</script>】,最新版本的Tida
参考文档
2.无线店铺装修注意
目前无线店铺装修支持无线开放分配的域名(*.ews.m.jaeapp.com),装修的时候直接黏贴具体的url即可,例如:
https://coolgame.ews.m.jaeapp.com/example/index.html
3.抽奖结果,游戏成绩展示
在调用Tida.showDrawResult之前,需要先调用Tida.queryScore获得历史数据,计算好是否最佳成绩isBest赋给参数。之后可以调用Tida.saveScore保存记录。
4.禁止客户端下拉刷新
需要禁止客户端的下拉刷新进行测试时,
天猫:url后面加上disableptf=1参数
手淘:在页面head标签内加个<meta id="stopUsePullRefresh"
value="true"
>
5.页面中必须调用Tida.ready之后才能调用之后的接口,初始化方法如下:
Tida.ready({
interactId:"", // 互动实列ID type string 若无抽奖模块,此参数无须传入。传错会走错误流程
module: [] // 应用所需要的模块。默认只有基础API。支持的模块有draw:抽奖;sensor:传感器;buy:交易;device:基础设备接口 social:社交相关 widget:客户端UI
}, function(){
// TODO
})
6.手淘H5页面上直接发起ajax请求到外部域名会不会有影响?
你好,当前如果是在Html页面上发起的ajax请求,当前的域名只支持*.ews.m.jaeapp.com,如果是其他外部域名,会导致请求无法正常发出。
7.分享目前只接受一个图片的url,注意这个图片url地址需要真实有效。在天猫iOS中需要ali的CDN地址才行
8.Tida对界面窗口操作的支持有哪些?
当前Tida jssdk对界面操作的支持包括:浮层弱提示、浮层菊花进度加载、更改标题栏、隐藏表体验、新窗口打开、关闭窗口、监听当前页面被激活状态等等。
具体参考demo: http://coolgame.ews.m.jaeapp.com/example/index.html
9.Tida.draw抽奖常见错误码:
0: 一切正常
500:服务端返回不可解析内容
501:try/catch捕获的错误 一般也认为服务端有异常
CE003:遇到这个需要重新强制授权,重新调用一下doAuth,refresh传true
PC008: 发放优惠券失败了,检查下该帐号里面的优惠券信息是不是非常多了。pc上登录帐号---我的淘宝---我的优惠信息。删掉多余的。
LOT03: 检查下奖池ID。
10.Tida自带浮层的尺寸情况:z-index为999
11.手淘/手猫 APP里,开发的H5页面,如何确保外部引入的脚本能正常执行?
引入的js源必须为https格式,同时确保js源里依赖的其他源也保持https格式;
所有脚本的执行需要在DOMContentLoaded后执行;
12.开始有授权的那个页面,需要将html body的height设置成100%;否则大屏底下会留白
13.Tida支持陀螺仪、手机方向等传感器接口,具体使用请参考文档://open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.VmbRyI&treeId=12&articleId=103961&docType=1
14.PC版互动应用,使用url oauth授权方式,url后统一增加&view=tmall_frame,from=fuwu参数,更新了样式,支持授权有效期内免登。
15.应用内多次抽奖(Tida.draw)逻辑的展示处理:
如果应用内有多次抽奖(Tida.draw)的逻辑,禁止连续调用showDrawResult,多次抽奖结果缓存下来,push到一个数组,在最终需要显示浮层的时候做为awards参数值传递
16.关于互动游戏安全的规范:
如果用户进入游戏页面,没有玩,时间到了。不要触发draw,直接调用showDrawResult,分数传0,结果传空数组
17.无线页面必须包括的标签
<!-- viewport内容以自己游戏实际需要进行调整 -->
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<meta name="format-detection" content="telephone=no">
<!-- stopUsePullRefresh是禁止手淘客户端上的下拉刷新行为 -->
<meta id="stopUsePullRefresh"/>
18.
PC端授权改进介绍:http://coolgame.play.m.jaeapp.com/doc/pc-auth-step.pdf
19. ajax去取值的时候,返回参数里面会包含所有的html页面信息,怎么解决
java通过明确设定response的头:
response.setHeader("Content-Type", "text/json");
spring框架可以直接通过在action上给个@ResponseBody注解来解决
php的话,给header("Content-Type: text/json");
FAQ
关于此文档暂时还没有FAQ