更新记录

1.0.3(2025-03-30)

  • 【更新】更新文档
  • 【修复】修复老版本引发的类型问题

1.0.2(2025-03-30)

  • 【修改】修改文档示例代码

1.0.1(2025-03-30)

  • 【更新】整体更新类型,使用方式
  • 【优化】优化部分代码逻辑
查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 4.26,Android:4.4,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_LIST,X_SMS_RESULT,X_SMS_OPTIONS } from "@/uni_modules/x-sms"
    export default {
        methods: {
            reqPermission() {
                xCheckSelfPermission({
                    success: (result:X_SMS_RESULT) =>{
                        console.log("申请权限成功")
                    },
                    fail: (result:X_SMS_RESULT) =>{
                        console.log("申请权限失败")
                    }
                } as X_SMS_OPTIONS)
            },
            readSMS() {
                xReadSms({
                    success: (result:X_SMS_RESULT) => {
                        console.log("获取数据成功",result.data)
                    },
                    fail: (result:X_SMS_RESULT) => {
                        console.log("获取数据失败",result.msg)
                    }
                } as X_SMS_OPTIONS)
            }
        }
    }
</script>

方法

名称 参数 描述
xCheckSelfPermission (options:X_SMS_OPTIONS) 请求短信权限
xReadSms (options:X_SMS_OPTIONS) 读取短信数据

X_SMS_OPTIONS 参数

名称 类型 描述
success Function (options:X_SMS_OPTIONS) => void
fail Function (options:X_SMS_OPTIONS) => void

X_SMS_RESULT 返回参数

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

X_SMS_LIST 属性

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

X插件系列

x-base-s【基础插件】安卓好用的基础工具

x-sms【短信插件】为X系列插件打造完美轮子

x-tencent-u【腾讯地图】

x-tencent-s【腾讯定位】保活和持久,保姆和小白式的完美解决方案

x-gaode-s【高德定位】保姆和小白式完美解决方案

x-icon-u【图标组件】

x-short-video-u是一个高性能,高度配置的短视频组件

x-im-sdk 为即时通讯量身打造, 适配Android,iOS,Web

隐私、权限声明

1. 本插件需要申请的系统权限列表:

读取短信权限

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问