短信服务

说明：

• 从 API Version 6 开始支持。

• 标记⁷⁺的接口从API Version 7开始支持。

导入模块

import sms from '@ohos.telephony.sms';

sms.createMessage

createMessage(pdu: Array<number>, specification: string, callback: AsyncCallback<ShortMessage>): void

根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用callback方式作为异步方法。

• 参数

  参数名	类型	必填	说明
  pdu	Array<number>	是	协议数据单元，从收到的信息中获取。
  specification	string	是	短信协议类型。 - 3gpp表示GSM/UMTS/LTE SMS - 3gpp2表示CDMA SMS
  callback	AsyncCallback<ShortMessage>	是	回调函数。

• 示例

  let specification = '3gpp';
  let pdu = [0x08, 0x91, ...];
  sms.createMessage(pdu, specification, (err, data) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
  });

sms.createMessage

createMessage(pdu: Array<number>, specification: string): Promise<ShortMessage>

根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用Promise方式作为异步方法。

• 参数

  参数名	类型	必填	说明
  pdu	Array<number>	是	协议数据单元，从收到的信息中获取。
  specification	string	是	短信协议类型。 - 3gpp表示GSM/UMTS/LTE SMS - 3gpp2表示CDMA SMS

• 返回值

  类型	说明
  Promise<ShortMessage>	以Promise形式返回创建的短信实例。

• 示例

  let specification = '3gpp';
  let pdu = [0x08, 0x91, ...];
  let promise = sms.createMessage(pdu, specification);
  promise.then(data => {
      console.log(`createMessage success, promise: data->${JSON.stringify(data)}`);
  }).catch(err => {
      console.error(`createMessage fail, promise: err->${JSON.stringify(err)}`);
  });

sms.sendMessage

sendMessage(options: SendMessageOptions): void

发送短信。

需要ohos.permission.SEND_MESSAGES权限。

• 参数

  参数名	类型	必填	说明
  options	SendMessageOptions	是	发送短信的参数和回调，参考SendMessageOptions。

• 示例

  let sendCallback = function (err, data) {    
      console.log(`sendCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 
  }
  let deliveryCallback = function (err, data) {    
      console.log(`deliveryCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 
  }
  let slotId = 0;
  let content = '短信内容';
  let destinationHost = '+861xxxxxxxxxx';
  let serviceCenter = '+861xxxxxxxxxx';
  let destinationPort = 1000;
  let options = {slotId, content, destinationHost, serviceCenter, destinationPort, sendCallback, deliveryCallback};
  sms.sendMessage(options);

sms.getDefaultSmsSlotId⁷⁺

getDefaultSmsSlotId(callback: AsyncCallback<number>): void

获取发送短信的默认SIM卡槽ID，使用callback方式作为异步方法。

• 参数

  参数名	类型	必填	说明
  callback	AsyncCallback<number>	是	回调函数。 - 0：卡槽1 - 1：卡槽2

• 示例

  sms.getDefaultSmsSlotId((err, data) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
  });

sms.getDefaultSmsSlotId⁷⁺

getDefaultSmsSlotId(): Promise<number>

获取发送短信的默认SIM卡槽ID，使用Promise方式作为异步方法。

• 返回值

  类型	说明
  Promise	以Promise形式返回发送短信的默认SIM卡： - 0：卡槽1 - 1：卡槽2

• 示例

  let promise = call.getDefaultSmsSlotId();
  promise.then(data => {
      console.log(`getDefaultSmsSlotId success, promise: data->${JSON.stringify(data)}`);
  }).catch(err => {
      console.error(`getDefaultSmsSlotId fail, promise: err->${JSON.stringify(err)}`);
  });

sms.setSmscAddr⁷⁺

setSmscAddr(slotId: number, smscAddr: string, callback: AsyncCallback<void>): void

设置短信服务中心（SMSC）地址，使用callback方式作为异步方法。

需要ohos.permission.SET_TELEPHONY_STATE权限，该权限为系统权限。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	SIM卡槽ID： - 0：卡槽1 - 1：卡槽2
  smscAddr	string	是	短信服务中心地址。
  callback	AsyncCallback<void>	是	回调函数。

• 示例

  let slotId = 0;
  let smscAddr = '+861xxxxxxxxxx';
  sms.setSmscAddr(slotId, smscAddr, (err,data) => {
        console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
  });

sms.setSmscAddr⁷⁺

setSmscAddr(slotId: number, smscAddr: string): Promise<void>

设置短信服务中心（SMSC）地址，使用Promise方式作为异步方法。

需要ohos.permission.SET_TELEPHONY_STATE权限，该权限为系统权限。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	SIM卡槽ID： - 0：卡槽1 - 1：卡槽2
  smscAddr	string	是	短信服务中心地址。

• 返回值

  类型	说明
  Promise<void>	以Promise形式异步返回设置结果。

• 示例

  let slotId = 0;
  let smscAddr = '+861xxxxxxxxxx';
  let promise = sms.setSmscAddr(slotId, smscAddr);
  promise.then(data => {
      console.log(`setSmscAddr success, promise: data->${JSON.stringify(data)}`);
  }).catch(err => {
      console.error(`setSmscAddr fail, promise: err->${JSON.stringify(err)}`);
  });

sms.getSmscAddr⁷⁺

getSmscAddr(slotId: number, callback: AsyncCallback<string>): void

获取短信服务中心（SMSC）地址，使用callback方式作为异步方法。

需要ohos.permission.GET_TELEPHONY_STATE权限，该权限为系统权限。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	SIM卡槽ID： - 0：卡槽1 - 1：卡槽2
  callback	AsyncCallback<string>	是	回调函数。

• 示例

  let slotId = 0;
  sms.getSmscAddr(slotId, (err, data) => {
        console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
  });

sms.getSmscAddr⁷⁺

getSmscAddr(slotId: number): Promise<string>

获取短信服务中心（SMSC）地址，使用Promise方式作为异步方法。

需要ohos.permission.GET_TELEPHONY_STATE权限，该权限为系统权限。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	SIM卡槽ID： - 0：卡槽1 - 1：卡槽2

• 返回值

  类型	说明
  Promise<string>	以Promise形式返回获取短信服务中心地址的结果。

• 示例

  let slotId = 0;
  let promise = sms.getSmscAddr(slotId);
  promise.then(data => {
      console.log(`getSmscAddr success, promise: data->${JSON.stringify(data)}`);
  }).catch(err => {
      console.error(`getSmscAddr fail, promise: err->${JSON.stringify(err)}`);
  });

ShortMessage

短信实例。

ShortMessageClass

短信类型。

SendMessageOptions

发送短信的参数和回调。

根据SendMessageOptions中的可选参数content的值判断短信类型。

ISendShortMessageCallback

回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。

IDeliveryShortMessageCallback

回调实例。返回短信送达报告。

SendSmsResult

短信发送结果。