抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 系统信息
  • 生命周期
  • 触摸事件
  • Touch
  • tt.onTouchStart
  • tt.onTouchMove
  • tt.onTouchEnd
  • tt.onTouchCancel
  • tt.offTouchStart
  • tt.offTouchMove
  • tt.offTouchEnd
  • tt.offTouchCancel
  • 应用级事件
  • 广告
  • 界面
  • 支付
  • Worker
  • tt.onTouchCancel
    收藏
    我的收藏

    基础库 1.0.0 开始支持本方法,这是一个同步方法。

    监听触点失效事件。

    前提条件
    业务背景
    使用限制
    注意事项
    相关教程

    语法

    tt.onTouchCancel(callback)

    参数说明

    callback

    类型默认值必填说明最低支持版本
    function
    监听事件的回调函数
    1.0.0

    callback 是一个回调函数,接收 object 类型的参数,属性如下:

    属性名类型说明最低支持版本
    touchesArray<object>

    Touch数组。当前所有触摸点的列表

    1.0.0
    changedTouchesArray<object>

    Touch数组。触发此次事件的触摸点列表

    1.0.0
    timeStampnumber
    事件触发时的时间戳
    1.0.0

    touches 类型说明

    object 类型,属性如下:

    属性名类型说明最低支持版本
    Touchobject
    Touch 对象表示在触控设备上的触摸点。通常是指手指或者触控笔在触屏设备或者触摸板上的操作
    1.0.0

    Touch 类型说明

    object 类型,属性如下:

    属性名类型说明最低支持版本
    identifiernumber
    Touch 对象的唯一标识符,只读属性。一次触摸动作(指手指的触摸)在平面上移动的整个过程中, 该标识符不变。 可以根据它来判断跟踪的是否是同一次触摸过程
    1.0.0
    screenXnumber
    触点相对于屏幕左边沿的 X 坐标
    1.0.0
    screenYnumber
    触点相对于屏幕上边沿的 Y 坐标
    1.0.0

    changedTouches 类型说明

    object 类型,属性如下:

    属性名类型说明最低支持版本
    Touchobject
    Touch 对象表示在触控设备上的触摸点。通常是指手指或者触控笔在触屏设备或者触摸板上的操作
    1.0.0

    Touch 类型说明

    object 类型,属性如下:

    属性名类型说明最低支持版本
    identifiernumber
    Touch 对象的唯一标识符,只读属性。一次触摸动作(指手指的触摸)在平面上移动的整个过程中, 该标识符不变。 可以根据它来判断跟踪的是否是同一次触摸过程
    1.0.0
    screenXnumber
    触点相对于屏幕左边沿的 X 坐标
    1.0.0
    screenYnumber
    触点相对于屏幕上边沿的 Y 坐标
    1.0.0

    返回值

    代码示例

    function touchCallback({ touches, changedTouches, timeStamp }) { console.log('触点失效回调', touches, changedTouches, timeStamp) }; tt.onTouchCancel(touchCallback);