• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • tt.getLocation
  • tt.openLocation
  • tt.chooseLocation
  • tt.startLocationUpdate
  • tt.stopLocationUpdate
  • tt.onLocationChange
  • tt.offLocationChange
  • tt.onLocationChangeError
  • tt.offLocationChangeError
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • tt.stopLocationUpdate
    收藏
    我的收藏

    基础库 2.48.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。

    停止接收位置更新。

    前提条件
    业务背景
    使用限制

    开发者工具暂不支持此能力,请用真机扫码调试。

    注意事项
    支持沙盒
    相关教程

    语法

    tt.stopLocationUpdate(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    successfunction
    接口调用成功的回调函数
    2.48.0
    failfunction
    接口调用失败的回调函数
    2.48.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    2.48.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "stopLocationUpdate:ok"
    2.48.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "stopLocationUpdate:fail" + 详细错误信息
    2.48.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    112901startLocationUpdate:fail the app does not apply for high-precision location permissionD
    没有高精度权限

    小程序没有高精度权限,满足申请条件后,开发者登录控制台,在小程序应用中筛选“能力-用户数据能力-设备数据”,申请获取高精度地理位置能力

    2.48.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

    <button bindtap="startListen">开始监听位置变化</button> <button bindtap="stopListen">停止监听位置变化</button>
    Page({ onLoad() { tt.onLocationChange((res) => { console.log("位置变化事件", res); }); }, startListen() { tt.startLocationUpdate({ success: (res) => { console.log("开始监听成功", res); }, fail(err) { console.log("开始监听失败", err); }, }); }, stopListen() { tt.stopLocationUpdate({ success: (res) => { console.log("停止监听成功", res); }, fail(err) { console.log("停止监听失败", err); }, }); }, });