短彩信

• 简介
• 目录
• 约束
• 接口说明
• 使用说明
  • 发送短信
  • 创建ShortMessage对象
• 相关仓

简介

短彩信模块为移动数据用户提供短信收发和彩信编解码功能，主要功能有GSM/CDMA短信收发、短信PDU（Protocol data unit，协议数据单元）编解码、Wap Push接收处理 、小区广播接收、彩信通知、 彩信编解码和SIM卡短信记录增删改查等。

图 1 短彩信模块架构图

短彩信模块由接口管理类、短信发送管理类、短信接收管理类，和彩信编解码工具类组成。其中：

• 接口管理类：SmsInterfaceManager 负责对外提供短信发送、SIM卡短信记录操作和配置相关接口，负责创建SmsSendManager 、SmsReceiveManager和smsMiscManager 对象。
• 短信发送管理类： SmsSendManager创建GSM(GsmSmsSender) 、CDMA(CdmaSmsSender) 和网络策略管理(SmsNetworkPolicyManager)对象，并根据网络制式调度对应的GSM或CDMA对象发送短信。
• 短信接收管理类： SmsReceiveManager 负责短信接收，监听来自RIL层的新短信信息；创建GSM(GsmSmsReceiveHandler) 和CDMA(CdmaSmsReceiveHandler) 对象；创建SmsWapPushHandler 和SmsCellBroadcastHandler 对象。
• 彩信编解码类：负责彩信PDU的编解码处理。
• Misc管理类：负责Sim卡短信操作、小区广播配置、短信服务中心地址配置和默认卡槽配置等。
• IMS短信管理类：ImsSmsClient 负责IMS短信发送，及设置/获取IMS短信配置信息。

目录

/base/telephony/sms_mms
├─ common                       # 内部公共代码
├─ figures                      # Readme资源文件
├─ frameworks                   # 短彩信内部框架接口层
│  ├─ js                        # js相关代码
│  └─ native                    # native相关代码
├─ interfaces                   # 接口目录
│  ├─ innerkits                 # 部件间的内部接口
│  │ └─  ims                    # IMS短信接口定义
│  └─ kits                      # 对应用提供的接口（例如JS接口）
├─ sa_profile                   # 短信服务的启动文件目录
├─ services                     # 短彩信服务实现代码
│  ├─ ims_service_interaction   # IMS短信服务交互层
│  ├─ include                   # 头文件目录
│  ├─ cdma                      # CDMA制式源文件
│  └─ gsm                       # GSM制式源文件
├─ test                         # 单元测试目录
│  ├─ fuzztest                  # 模糊测试相关代码
│  ├─ gtest                     # 自动化测试相关代码
│  └─ unittest                  # 单元测试相关代码
└─ utils                        # 通用工具相关

约束

• 开发语言：JavaScript。
• 软件约束，需要与以下服务配合使用：Telephony核心服务（core_service）；依赖glib库。
• 硬件约束，需要搭载的设备支持以下硬件：可以进行独立蜂窝通信的Modem以及SIM卡。

接口说明

表 1 短彩信对外提供的接口

表 2 发送短信接口参数SendMessageOptions说明

表 3 ISendShortMessageCallback类型说明

表 4 SendSmsResult枚举值

表 5 IDeliveryShortMessageCallback类型说明

表 6 createMessage接口参数说明

表 7 getDefaultSmsSlotId接口参数说明

表 8 setSmscAddr接口参数说明

表 9 getSmscAddr接口参数说明

表 10 创建短信异步回调ShortMessage说明

表 11 getDefaultSmsSimId接口参数说明

完整的JS API说明以及实例代码请参考：收发短信

使用说明

发送短信

以发送普通文本短信为例，主要步骤和代码如下：

1. 构造SendMessageOptions对象，传入必要的参数；若关注发送结果或送达报告，需要传入sendCallback或deliveryCallback对象。

2. 可以通过callback或者Promise的方式调用sendMessage接口。

3. 该接口为异步接口，相关执行结果会从callback中返回。

   import sms from "@ohos.telephony.sms";
   
   let msg: SendMessageOptions = {
     slotId: 0,
     destinationHost: '123xxxxxxxx',
     content: '这是一封短信',
     sendCallback: (err, data) => {
       if (err) {
         // 接口调用失败，err非空
         console.error(`failed to send message because ${err.message}`);
         return;
       }
       // 接口调用成功，err为空
       console.log(`success to send message: ${data.result}`);
     }
   }
   
   // 调用接口
   sms.sendMessage(msg);

创建ShortMessage对象

以解析3gpp类型的PDU，调用createMessage为例，主要步骤和代码如下：

1. 构造短信的PDU，指定协议类型为3gpp或者3gpp2。

2. 可以通过callback或者Promise的方式调用createMessage接口。

3. 该接口为异步接口，成功后获取ShortMessage 对象属性来得到解析后的短信息数据。

   import sms from "@ohos.telephony.sms";
   
   let pdu = [80, 80, 80]; // 这里只是表示是短信PDU，并非真实短信
   let specification = "3gpp";
   
   // 调用接口【callback方式】
   sms.createMessage(pdu, specification, (err, value) => {
     if (err) {
       // 接口调用失败，err非空
       console.error(`failed to createMessage because ${err.message}`);
       return;
     }
     // 接口调用成功，err为空
     console.log(`success to createMessage: ${value}`);
   });
   
   // 调用接口【Promise方式】
   let promise = sms.createMessage(pdu, specification);
   promise.then((value) => {
     // 接口调用成功，此处可以实现成功场景分支代码。
     console.log(`success to createMessage: ${value}`);
   }).catch((err) => {
     // 接口调用失败，此处可以实现失败场景分支代码。
     console.error(`failed to createMessage because ${err.message}`);
   });

发送彩信

以中国联通SIM卡发送彩信为例，主要步骤和代码如下：

1. 发送彩信，需要先编码再发送。

2. 编码：将多媒体文件编码成彩信pdu。app将多媒体文件放入沙箱，调用编码接口encodeMms，app传入必要参数，返回的彩信pdu需要app写入沙箱

3. 发送：将彩信pdu发送到对端手机。调用发送接口sendMms，app需传入必要参数，彩信中心需和运营商卡匹配。

4. 可以通过callback或者Promise的方式调用sendMessage接口。

5. 该接口为异步接口，相关执行结果会从callback中返回。

   import mms from "@ohos.telephony.sms";
   
   // 获取MmsType,输入本机号码,目的手机号码
   async function getMmstype(tid){
     return {
       from : {address: '+86xxxxxxxxxxx/TYPE=PLMN', charset: mms.UTF_8},
       to: [{address: '+86xxxxxxxxxxx/TYPE=PLMN', charset: mms.UTF_8}],
       contentType: "application/vnd.wap.multipart.related",
       transactionId: tid,
       version: mms.MMS_VERSION_1_2,
       subject: "Test mms"
     };
   }
   let MMSTYPE = await getMmstype("1");
   
   // 只包括图片附件，图片名字picture.gif
   const ATTACHMENT_PICTURE = [
     {path: sandPath + 'picture.gif',
       fileName: 'picture.gif',
       contentId:'<picture.gif>',
       contentLocation:'picture.gif',
       contentDisposition: mms.ATTACHMENT,
       contentTransferEncoding: 'binary',
       contentType:'image/gif',
       isSmil: false,
       inBuff: [],
       charset: mms.UTF_8
     }
   ];
   
   // 编码彩信pdu
   const wrapperStepForEncodeMms = async function (mmsType, attachment) {
     try {
       // 调用编码接口
       const encodeData = await mms.encodeMms({messageType: mms.TYPE_MMS_SEND_REQ, mmsType, attachment});
       console.log(`encodeMms Success, data length:${encodeData.length}`);
       await writefd(casename, encodeData);
     } catch (error) {
       throw error;
     }
   };
   
   // 进行彩信pdu编码,编码前将图片放入沙箱
   try {
     await wrapperStepForEncodeMms(MMSTYPE, ATTACHMENT_PICTURE);
     console.log(`wrapperStepForEncodeMms success.`);
   } catch (error) {
     console.log(`wrapperStepForEncodeMms fail, error: ${toString(error)}`);
     return;
   }
   
   const sandBoxPath = '/data/storage/el2/base/files/';
   let filePath  = sandBoxPath + 'SendReq.mms';
   // 彩信pdu写入沙箱
   async function writefd(array){
     let data = new Uint8Array(array).buffer;
     try {
       let fd = await fileio.open(filePath , 0o102, 0o666);
       console.log(`fd: ${toString(fd)}`);
       const number = await fileio.write(fd, data);
       console.log(`write data to file success number: ${toString(number)}`);
       await fileio.close(fd);
     } catch (error) {
       console.log(`write data to file failed with error: ${toString(error)}`);
     }
   }
   
   // 彩信用户代理、用户代理描述配置。根据运营商要求配置，默认ua，uaprof
   let mmsCfg = {
     userAgent:'ua',
     userAgentProfile: 'uaprof'
   };
   
   // 发送彩信参数
   let mmsParams = {
     slotId : DEFAULT_SLOTID,
     mmsc: 'http://mmsc.myuni.com.cn',
     data: filePath,
     mmsConfig: mmsCfg
   };
   // 调用发送接口
   mms.sendMms(globalThis.context, mmsParams, async(err) =>{
     if (err) {
       console.log(`sendMms fail, err : ${toString(err)}`);
       return;
     }
     console.log(`sendMms Success`);
   }

相关仓

电话服务子系统

telephony_sms_mms

telephony_core_service