获取短信列表 (sms.list)

Android 扩展

此函数为 Android 平台扩展，仅在 NBTouch (Android) 上可用。

声明

结果 = sms.list([{
    type = 短信类型,
    offset = 偏移量,
    limit = 限制数量,
}])

参数及返回值

• 短信类型
  • 整数型，可选，默认 0（所有）
  • sms.TYPE_ALL (0) - 所有短信
  • sms.TYPE_INBOX (1) - 收件箱
  • sms.TYPE_SENT (2) - 已发送
  • sms.TYPE_DRAFT (3) - 草稿
  • sms.TYPE_OUTBOX (4) - 待发送
  • sms.TYPE_FAILED (5) - 发送失败
  • sms.TYPE_QUEUED (6) - 队列中
• 偏移量
  • 整数型，可选，默认 0
• 限制数量
  • 整数型，可选，默认 100
• 结果
  • 文本型，JSON 格式的响应字符串

说明

获取短信列表，支持按类型筛选和分页。

示例

-- 获取所有短信
local result = sms.list()

-- 获取收件箱短信
local result = sms.list({ type = sms.TYPE_INBOX })

-- 获取已发送短信，分页获取
local result = sms.list({
    type = sms.TYPE_SENT,
    offset = 0,
    limit = 50
})

-- 解析结果
local data = json.decode(result)
if data.code == 200 then
    print("共有", data.data.count, "条短信")
    for _, msg in ipairs(data.data.list) do
        print(msg.address, msg.body)
    end
end

返回示例

{
  "code": 200,
  "data": {
    "type": 0,
    "offset": 0,
    "limit": 100,
    "count": 1,
    "list": [
      {
        "_id": 1,
        "address": "13800001234",
        "body": "这是一条测试短信",
        "date": 1736412345000,
        "type": 1,
        "type_name": "MESSAGE_TYPE_INBOX",
        "read": 1,
        "seen": 1,
        "creator": "com.android.messaging",
        "contact": {
          "_id": 3,
          "display_name": "张三"
        }
      }
    ]
  },
  "msg": "OK"
}

返回字段说明

字段名	类型	说明
_id	long	短信唯一 ID
address	string	对方号码
body	string	短信内容
date	long	时间戳 (毫秒)
type	int	短信类型
type_name	string	类型名称
read	int	是否已读：1=是, 0=否
seen	int	是否已展示：1=是, 0=否
creator	string	创建者包名
contact	object	关联联系人信息