Device API

Device API

振动

vibrateShort(options)

执行短振动 (15ms)。

选项:

参数	类型	必填	说明
type	string	-	振动强度 ('heavy' | 'medium' | 'light')
success	function	-	成功回调
fail	function	-	失败回调
complete	function	-	完成回调

TudadaSDK.vibrateShort({
  type: 'medium',
  success: () => console.log('振动执行'),
});

vibrateLong(options)

执行长振动 (400ms)。

选项:

参数	类型	必填	说明
success	function	-	成功回调
fail	function	-	失败回调
complete	function	-	完成回调

TudadaSDK.vibrateLong({
  success: () => console.log('长振动执行'),
});

键盘

showKeyboard(options)

显示虚拟键盘。

选项:

参数	类型	必填	说明
defaultValue	string	-	默认输入值
maxLength	number	-	最大输入长度
multiple	boolean	-	是否多行输入
confirmHold	boolean	-	确认后是否保持键盘
confirmType	string	-	确认按钮类型 ('done' | 'next' | 'search' | 'go' | 'send')
success	function	-	成功回调
fail	function	-	失败回调
complete	function	-	完成回调

TudadaSDK.showKeyboard({
  defaultValue: '',
  maxLength: 100,
  multiple: false,
  confirmHold: false,
  confirmType: 'done',
  success: () => console.log('键盘已显示'),
});

hideKeyboard()

隐藏虚拟键盘。

TudadaSDK.hideKeyboard();

onKeyboardInput(callback) / offKeyboardInput(callback?)

注册/注销键盘输入事件监听器。

回调参数:

字段	类型	说明
value	string	当前输入值

TudadaSDK.onKeyboardInput((res) => {
  console.log('当前输入值:', res.value);
});

// 移除所有监听器
TudadaSDK.offKeyboardInput();
// 移除特定监听器
TudadaSDK.offKeyboardInput(myFn);

onKeyboardConfirm(callback) / offKeyboardConfirm(callback?)

注册/注销键盘确认按钮点击事件监听器。

回调参数:

字段	类型	说明
value	string	确认时的输入值

TudadaSDK.onKeyboardConfirm((res) => {
  console.log('已确认:', res.value);
});

TudadaSDK.offKeyboardConfirm();

onKeyboardComplete(callback) / offKeyboardComplete(callback?)

注册/注销键盘输入完成事件监听器。

回调参数:

字段	类型	说明
value	string	完成时的输入值

TudadaSDK.onKeyboardComplete((res) => {
  console.log('完成:', res.value);
});

TudadaSDK.offKeyboardComplete();