Downloading Data

This topic describes how your application can download data from a remote server.

Samsung devices support downloading data from a remote server, using the Download API. For example, you can download external subtitles for a video.

Prerequisites

To use the Download API, the application has to request permission by adding the following privilege to the "config.xml" file:

<tizen:privilege name='http://tizen.org/privilege/download'></tizen:privilege>

Starting a Download

To download data:

  1. Check that downloading is supported using the getCapability() method of the SystemInfo API:

    var downloadPossible = 
      tizen.systeminfo.getCapability('http://tizen.org/feature/download');
console.log(downloadPossible);

  2. Create a download request object using the DownloadRequest() method:

    var download_obj = new tizen.DownloadRequest('http://download.tizen.org/tools/README.txt', 'downloads');

  3. Start the download using the start() method, with the download request object as a parameter:

    tizen.download.start(download_obj, {
  onprogress: function(id, receivedSize, totalSize) {
    console.log(id);
    console.log(receivedSize);
    console.log(totalSize);
  },
  onpaused: function(id) {
    console.log(id);
  },
  oncanceled: function(id) {
    console.log(id);
  },
  oncompleted: function(id, fullPath) {
    console.log(id);
    console.log(fullPath);
  },
  onfailed: function(id, error) {
    console.log(id);
    console.log(JSON.stringify(error));
  }
});

    When downloading is complete, the oncompleted() event handler fires.