deviceSettings

配置调整

deviceSettings 用于修改设备级配置，例如设备名称、语言、Passphrase 开关、自动锁定时间等。由于这些操作通常需要在设备上确认，建议一次只修改一个属性，方便用户理解本次变更。

const callResult = await ukeySdk.deviceSettings(connectId, requestParams);

入参配置

常见入参（CommonParams）

• language - string；设备语言，使用 ISO 639-1 代码。

• label - string；设备展示名称。

• usePassphrase - boolean；开启 Passphrase 功能。

• homescreen - string；用于替换主屏壁纸的十六进制数据。

• autoLockDelayMs - number；自动锁屏延迟，单位毫秒。

• displayRotation - number；屏幕方向设置。

• passphraseAlwaysOnDevice - boolean；强制在设备端输入 Passphrase，不走软件输入。

• safetyChecks - string；安全校验级别，Prompt 会限制路径命名空间校验。

  0: Strict 1: PromptAlways 2: PromptTemporarily

• experimentalFeatures - boolean；启用实验消息类型。

调用例子

ukeySdk.deviceSettings(connectId, {
    slot: 'My UKey Wallet'
});

结果

{
    success: true,
    payload: {
        message: string
    }
}

报错

{
    success: false,
    payload: {
        error: string, // 出错说明
        code: number // 状态码
    }
}