跳到主要内容

添加短信记录 (sms.add)

Android 扩展

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

声明​

结果 = sms.add(对方号码, 短信内容[, {
    type = 短信类型,
    date = 时间戳,
    read = 是否已读,
    seen = 是否已展示,
}])

参数及返回值​

  • 对方号码
    • 文本型，发送方或接收方的电话号码
  • 短信内容
    • 文本型，短信正文
  • 短信类型
    • 整数型，可选，默认 1（收件箱）
    • sms.TYPE_INBOX (1) - 收件箱
    • sms.TYPE_SENT (2) - 已发送
    • sms.TYPE_DRAFT (3) - 草稿
  • 时间戳
    • 整数型，可选，毫秒时间戳，默认当前时间
  • 是否已读
    • 布尔型，可选，默认 true
  • 是否已展示
    • 布尔型，可选，默认 true
  • 结果
    • 文本型，JSON 格式的响应字符串

说明​

向短信数据库添加一条短信记录。此操作只是添加数据库记录，不会触发系统通知。

如需模拟接收短信并触发系统通知，请使用 sms.receive。

示例​

-- 添加收件箱短信
local result = sms.add("13800138000", "这是一条测试短信")

-- 添加已发送短信
local result = sms.add("13800138000", "这是我发送的短信", {
    type = sms.TYPE_SENT,
    read = true,
    seen = true
})

-- 添加指定时间的短信
local result = sms.add("13800138000", "历史短信", {
    type = sms.TYPE_INBOX,
    date = 1736412345000  -- 毫秒时间戳
})

-- 解析结果
local data = json.decode(result)
if data.code == 200 then
    print("添加成功，ID:", data.data[1]._id)
end

返回示例​

{
  "code": 200,
  "data": [
    {
      "_id": 1,
      "address": "13800138000",
      "body": "这是一条测试短信",
      "date": 1736412345000,
      "type": 1,
      "type_name": "MESSAGE_TYPE_INBOX",
      "read": 1,
      "seen": 1
    }
  ],
  "msg": "OK"
}