x-sendsms-s 发送短信
拉起系统短信编辑界面,预填手机号和内容。参数与回调对齐微信 wx.sendSms 和 DCloud success / fail / complete。对外方法名为 xSendSms,类型统一加 X 前缀,避免和系统或微信同名冲突。
成功只表示已经打开短信面板,不代表用户一定发送成功。不会在后台静默发短信。
兼容性
| Harmony | iOS | Android | WEB | 微信小程序 |
|---|---|---|---|---|
| 支持 | 支持 | 支持 | 移动端浏览器 | 支持 |
调用
ts
import { xSendSms, XSendSmsOptions } from "@/uni_modules/x-sendsms-s"
xSendSms({
phoneNumber: "10086",
content: "查询话费",
success: (res) => {
console.log(res.errMsg)
},
fail: (err) => {
console.log(err.errCode, err.errMsg)
}
} as XSendSmsOptions)多个号码用英文逗号分隔:
ts
xSendSms({
phoneNumber: "10086,10010",
content: "你好"
} as XSendSmsOptions)方法
| 名称 | 说明 |
|---|---|
| xSendSms | 拉起系统短信编辑界面 |
参数
XSendSmsOptions
| 字段 | 说明 | 默认 |
|---|---|---|
| phoneNumber | 预填手机号,多个用英文逗号分隔 | 空 |
| content | 预填短信内容 | 空 |
| success | 成功,errMsg 为 xSendSms:ok | - |
| fail | 失败 | - |
| complete | 结束 | - |
phoneNumber 和 content 都可空,空值时打开空白短信面板。
错误码
| 码 | 含义 |
|---|---|
| 1001 | 系统错误,或正在拉起短信界面 |
| 1002 | 参数错误 |
| 1003 | 当前设备不支持发送短信 |
| 1008 | 当前平台不支持此功能 |
平台差异
- 微信走官方
wx.sendSms,基础库 2.25.0+。 - Android 使用
ACTION_SENDTO+smsto:,不申请SEND_SMS。 - iOS 使用系统
MFMessageComposeViewController,模拟器通常会返回 1003。 - HarmonyOS 通过
sms:协议startAbility拉起系统短信应用。 - Web 仅在移动端浏览器用
sms:链接;桌面端返回 1003。
版本
版权归 https://xui.tmui.design 你不得修改及二次开发,仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用,一经查实数倍赔偿,并追究法律责任。
更新日志
1.0.0(2026-08-16)
- 新增
xSendSms,支持 Android / iOS / HarmonyOS / Web / 微信小程序拉起系统短信面板
