原生小程序开发设备 API —— 屏幕、电话 API 汇总

屏幕 API

ty.getScreenBrightness

获取手机屏幕亮度

需引入BaseKit，且在>=2.3.2版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
value	number	屏幕亮度值，范围 0 ~ 1。0 最暗，1 最亮

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

函数定义示例

/**
 * 获取屏幕亮度
 */
export function getScreenBrightness(params?: {
  complete?: () => void;
  success?: (params: {
    /** 屏幕亮度值，范围 0 ~ 1。0 最暗，1 最亮 */
    value: number;
  }) => void;
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

 

ty.setKeepScreenOn

设置是否保持常亮状态

需引入BaseKit，且在>=2.3.2版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
keepScreenOn	boolean		是	是否保持屏幕常亮
complete	function		否	接口调用完成的回调函数（成功或失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

函数定义示例

/**
 * 设置是否保持常亮状态
 */
export function setKeepScreenOn(params: {
  /** 是否保持屏幕常亮 */
  keepScreenOn: boolean;
  complete?: () => void;
  success?: (params: null) => void;
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。  

ty.setScreenBrightness

设置手机屏幕亮度

需引入BaseKit，且在>=2.3.2版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
value	number		是	屏幕亮度值，范围 0 ~ 1。0 最暗，1 最亮
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

函数定义示例

/**
 * 设置屏幕亮度
 */
export function setScreenBrightness(params: {
  /** 屏幕亮度值，范围 0 ~ 1。0 最暗，1 最亮 */
  value: number;
  complete?: () => void;
  success?: (params: null) => void;
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

电话 API

ty.makePhoneCall

拨打电话

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
phoneNumber	string		是	需要拨打的电话号码
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

函数定义示例

/**
 * 拨打电话
 */
export function makePhoneCall(params: {
  /** 需要拨打的电话号码 */
  phoneNumber: string;
  complete?: () => void;
  success?: (params: null) => void;
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。