x-sms【短信插件】 - DCloud 插件市场

更新记录

1.0.0（2024-08-30）

【新增】初始化第一版本
【新增】新增申请短信权限和读取短信列表方法

平台兼容性

Vue2	Vue3
√	√

App	快应用	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序
HBuilderX 4.26，Android：6.0，iOS：不支持，HarmonyNext：不确定	×	×	×	×	×	×

钉钉小程序	快手小程序	飞书小程序	京东小程序
×	×	×	×

H5-Safari	Android Browser	微信浏览器(Android)	QQ浏览器(Android)	Chrome	IE	Edge	Firefox	PC-Safari
×	×	×	×	×	×	×	×	×

x-sms 短信插件

UTS插件，需要打包自定义基座。
如果您不会打包或使用，请在上方uni-im群提出你的疑问。

示例

<template>
    <view class="cell">
        <button class="cell-btn" @click="reqPermission">申请短信权限</button>
        <button class="cell-btn" @click="readSMS">读取短信列表</button>
    </view>
</template>

<script>
    import { xCheckSelfPermission,xReadSms, X_SMS_RESULT_TYPE, } from "@/uni_modules/x-sms"
    export default {
        methods: {
            reqPermission() {
                xCheckSelfPermission((result: X_SMS_RESULT_TYPE) => {
                    console.log(result)
                })
            },
            readSMS() {
                xReadSms((result: X_SMS_RESULT_TYPE) => {
                    console.log(result)
                })
            }
        }
    }
</script>

方法

名称	参数	描述
xCheckSelfPermission	(result: X_SMS_RESULT_TYPE) => void	请求短信权限
xReadSms	(result: X_SMS_RESULT_TYPE) => void	读取短信数据

X_SMS_RESULT_TYPE 返回参数

名称	类型	描述
code	Number	状态码
msg	String	状态消息
data	Array	短信数据

X_SMS_LIST_TYPE 属性

名称	类型	描述
id	Long \| null	短信的唯一标识符（ID）
threadId	Int \| null	短信线程的ID，通常同一发件人或对话的短信会有相同的thread_id。
address	String \| null	发件人的手机号码或短信服务中心的地址。
person	Int \| null	如果发件人是联系人，这是其在联系人数据库中的ID；如果是陌生人，则为null。
date	Long \| null	短信的接收或发送时间（时间戳）。
protocol	Int \| null	短信使用的协议（如0表示SmsProtocol.SMS_PROTO）。
read	boolean \| null	表示短信是否已被阅读（true表示已读，false表示未读）。
status	Int \| null	短信的状态（如-1表示正在接收，0表示正常，64表示待处理，128表示失败）。
type	Int \| null	短信的类型（如1表示收件箱，2表示已发送，等等）。
body	String \| null	短信的文本内容。
service_center	string \| null	短信服务中心的号码，通常是短信通过哪个服务中心发送的。
subject	string \| null	短信的主题，对于MMS（多媒体短信）有效。
reply_path_present	boolean \| null	表示短信是否有回复路径（true表示有，false表示无）。
locked	boolean \| null	表示短信是否被锁定（true表示被锁定，false表示未锁定）。