Sending SMS messages in Symbian Web Runtime
Article Metadata
Code Example
Source file: Media:Sending sms messages in WRT.zip
Compatibility
Platform(s): S60 5th Edition and later
Article
Keywords: device.getServiceObject(), Service.Messaging.Send()
Created: ivruban
(10 Dec 2008)
Last edited: hamishwillee
(04 Oct 2012)
Contents |
Overview
This code snippet shows how to send SMS messages synchronously and asynchronously using the Messaging Platform Service for Symbian Web Runtime.
To obtain access to the service object for the Messaging Service API, the device.getServiceObject("Service.Messaging", "IMessaging") method is used.
After setting the correct values for the message type (criteria.MessageType), recipient (criteria.To), and body text of the message (criteria.BodyText), the IMessaging.Send(criteria) method is used to send the SMS.
Source
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<script type="text/javascript" src="sendMessage.js" />
<title></title>
</head>
<body>
<div id="bodyContent" class="bodyContent">
<input type="checkbox" id="async" />
<label for="async">Send asynchronously</label><br />
<label for="phoneNumber">Phone number:</label><br />
<input type="text" id="phoneNumber" size="12" maxlength="12" />
<br />
<label for="message">Message:</label><br />
<textarea id="message" cols="40" rows="3"></textarea><br />
<input type="button" value="Send" onclick="sendSMS();" />
</div>
</body>
</html>
Source: sendMessage.js
var serviceObj = null;
window.onload = init;
// Initializes the widget
function init() {
// Obtain the service object
try {
serviceObj = device.getServiceObject("Service.Messaging",
"IMessaging");
} catch (ex) {
alert("Service object cannot be found.");
return;
}
}
function sendSMS() {
var criteria = new Object();
//Setting the type of the message
criteria.MessageType = "SMS";
var phoneNumber = document.getElementById("phoneNumber").value;
if (phoneNumber != null) {
//Setting the "To" field of the message, can't be empty
criteria.To = phoneNumber;
} else {
alert("Phone number is empty");
return;
}
var messageText = document.getElementById("message").value;
if (messageText != null) {
//Setting the body text field of the message, can't be empty
criteria.BodyText = messageText;
} else {
alert("Text is empty");
return;
}
try {
if (document.getElementById("async").checked == false) {
//Send the message synchronously
var result = serviceObj.IMessaging.Send(criteria);
checkError(result);
} else {
//Send the message asynchronously
serviceObj.IMessaging.Send(criteria, onSendDone);
}
} catch(exception) {
alert("SendSMS error: " + exception);
}
}
// Called when asynchronous message sending has completed
function onSendDone(transId, eventCode, result) {
checkError(result);
}
function checkError(error) {
if (error.ErrorCode != 0) {
alert("Error in sending message");
} else {
alert("Message was sent succesfully");
}
}
Postconditions
- When the snippet is started, the user can choose to send the SMS synchronously or asynchronously (check box).
- Input field is used to define the receiver's phone number.
- To send the message press "Send".
Supplementary material
You can view the source file and the executable application in the attached ZIP archive. The archive is available for download at Media:Sending sms messages in WRT.zip.
I am tring to open the native sms window from my widget application. But I can't find a sutable method for that. Is this possible using widget SDK?