Notification API

Methods

post

Posts a notification to display.

void post(Notification notification);

Since: 2.0

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Parameters:

• notification: A notification to post.

Exceptions:

• WebAPIException

  • with error type InvalidValuesError, if any of the input parameters contain an invalid value.

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  var appControl = new tizen.ApplicationControl(
      "http://tizen.org/appcontrol/operation/create_content", null, "image/jpg", null);
  var notificationDict =
  {
    content: "This is a simple notification.",
    iconPath: "images/image1.jpg",
    soundPath: "music/Over the horizon.mp3",
    vibration: true,
    appControl: appControl
  };

  var notification =
      new tizen.StatusNotification("SIMPLE", "Simple notification", notificationDict);

  tizen.notification.post(notification);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

update

Updates a previously posted notification.

void update(Notification notification);

Since: 2.0

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Parameters:

• notification: A notification to update.

Exceptions:

• WebAPIException

  • with error type InvalidValuesError, if any of the input parameters contain an invalid value.

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  /* Uses a variable for the previously posted notification. */
  notification.content = "My notification";
  tizen.notification.update(notification);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

remove

Removes a previously posted notification.

void remove(NotificationId id);

Since: 2.0

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Parameters:

• id: A previously posted notification ID to remove.

Exceptions:

• WebAPIException

  • with error type NotFoundError, if NotificationId is not found in the previously posted notification.

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  /* Uses a variable for the previously posted notification. */
  tizen.notification.remove(notification.id);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

removeAll

Removes all notifications that have been posted by the current application.

void removeAll();

Since: 2.0

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Exceptions:

• WebAPIException

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  tizen.notification.removeAll();
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

get

Gets a notification that has previously been posted by the current application. Note that the obtained notification's progressType is PERCENTAGE

Notification get(NotificationId id);

Since: 2.0

Parameters:

• id: A previously posted notification ID.

Return value:

Notification: Notification posted previously by the current application.

Exceptions:

• WebAPIException

  • with error type NotFoundError, if NotificationId is not found in the previously posted notifications.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  /* Uses a variable for the previously posted notification. */
  /* Saves the notification ID for future use. */
  var myId = notification.id;

  var myNotification = tizen.notification.get(myId);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

getAll

Gets all notifications that have previously been posted by the current application. Note that the obtained notification's progressType is PERCENTAGE

Notification[] getAll();

Since: 2.0

Return value:

Notification[]: All notifications previously been posted by the current application.

Exceptions:

• WebAPIException

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  var notifications = tizen.notification.getAll();

  for (var index = 0; index < notifications.length; index++)
  {
    console.log(notifications[index].id);
    console.log(notifications[index].title);
    console.log(notifications[index].statusType);
    console.log(notifications[index].type);
    console.log(notifications[index].content);
    console.log(notifications[index].postedTime);
    console.log(notifications[index].iconPath);
    console.log(notifications[index].soundPath);
    console.log(notifications[index].vibration);
    console.log(notifications[index].appControl);
  }
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

playLEDCustomEffect

Plays the custom effect of the service LED that is located to the front of a device.

void playLEDCustomEffect(long timeOn, long timeOff, DOMString color, LEDCustomFlags[] flags);

Since: 2.4

Given parameters consist of timeOn and timeOff in milliseconds, RGBA color and LEDCustomFlags combination. For the color first three bytes are RGB values. The last byte is opacity. For example "#FFFF0080". There is also another possibility when the last byte is not given (in this case alpha is assumed to have a value of 0xff). In this case only RGB values are given. For example: "#ff0000" that is equivalent of "#ff0000ff".

Privilege level: public

Privilege: http://tizen.org/privilege/led

Parameters:

• timeOn: Turn on time in milliseconds.
• timeOff: Turn off time in milliseconds.
• color: The RGBA color value. The first three bytes are RGB values. The last byte is opacity. Exemplary string "#FFFF0080".
• flags: The combination of enum LEDCustomFlags.

Exceptions:

• WebAPIException

  • with error type InvalidValuesError, if any of the input parameters contain an invalid value.

  • with error type SecurityError, if the application does not have the privilege to call this method or if the author signature does not match that of the designated application.

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter

  • with error type UnknownError, if the method cannot be completed because of an unknown error.

Code example:

try
{
  tizen.notification.playLEDCustomEffect(
      1000, 1000, "#FFFF0080", ["LED_CUSTOM_DUTY_ON", "LED_CUSTOM_DEFAULT"]);
}
catch (err)
{
  console.log("Error Exception, error name : " + err.name + ", error message : " + err.message);
}

stopLEDCustomEffect

Stops the custom effect of the service LED that is located to the front of a device.

void stopLEDCustomEffect();

Since: 2.4

Privilege level: public

Privilege: http://tizen.org/privilege/led

Exceptions:

• WebAPIException

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type UnknownError, if the method cannot be completed because of an unknown error.

Code example:

try
{
  tizen.notification.playLEDCustomEffect(
      1000, 1000, "#FFFF0080", ["LED_CUSTOM_DUTY_ON", "LED_CUSTOM_DEFAULT"]);
  setTimeout(function()
  {
    tizen.notification.stopLEDCustomEffect();
  }, 5000);
}
catch (err)
{
  console.log("Error Exception, error name : " + err.name + ", error message : " + err.message);
}