System Settings

You can access and modify some system settings properties, such as the home screen and lock screen wallpaper image, incoming call ringtone, and email notification tone.

This feature is supported in mobile and wearable applications only.

The main features of the System Setting API include the following:

• Device wallpaper management

  You can set the wallpaper of the home and lock screen.

• Device ringtone and notification tone management

  You can set the ringtone for incoming calls and the tone for email notifications.

Prerequisites

To use the System Setting API (in mobile and wearable applications), the application has to request permission by adding the following privilege to the config.xml file:

<tizen:privilege name="http://tizen.org/privilege/setting"/>

Manage the device wallpapers

You can change the home and lock screen images by using the setProperty() method of the SystemSettingManager interface (in mobile and wearable applications). Similarly, you can retrieve information about them by using the getProperty() method.

To set the device wallpaper and get information about it:

• To set the specified image as the lock screen wallpaper, use the setProperty() method:

  function setLockscreenWallpaper() {
      tizen.filesystem.resolve('images/Background.jpg', function(imageFile) {
          try {
              tizen.systemsetting.setProperty('LOCK_SCREEN',
                                              imageFile.toURI().replace('file://', ''),
                                              successCB, errorCB);
          } catch (error) {
              console.log('Error: ' + error);
          }
      });
  }
  

• To get the current system setting information for the home screen wallpaper, use the getProperty() method:

  function getHomescreenWallpaper() {
      try {
          tizen.systemsetting.getProperty('HOME_SCREEN', successCB, errorCB);
      } catch (error) {
          console.log('Error: ' + error);
      }
  }
  

Manage ringtones and notification tones

You can modify the incoming call ringtone and notification email tone sound by using the setProperty() method of the SystemSettingManager interface (in mobile and wearable applications). Similarly, you can retrieve information about them by using the getProperty() method.

To set ringtones and notification tones, follow these steps:

• To set the specified audio file as the notification tone for emails, use the setProperty() method of the SystemSettingManager interface:

  function onSet() {
      console.log('It\'s set');
  }
  
  tizen.filesystem.resolve('music/Favorite track.mp3', function(musicFile) {
      try {
          tizen.systemsetting.setProperty('NOTIFICATION_EMAIL',
                                          musicFile.toURI().replace('file://', ''),
                                          onSet);
      } catch (error) {
          console.log('Error: ' + error);
      }
  });
  

• To get the current system setting information for the incoming call ringtone, use the getProperty() method:

  function onGet(value) {
      console.log('Current setting option value is: ' + value);
  }
  
  try {
      tizen.systemsetting.getProperty('INCOMING_CALL', onGet);
  } catch (error) {
      console.log('Error: ' + error);
  }
  

System settings properties

The following table lists the supported system settings properties.

Table: Available properties

Related information

• Dependencies
  • Tizen 2.4 and Higher for Mobile
  • Tizen 2.3.1 and Higher for Wearable