SetLockScreenWallpaper BB10 Cordova Plugin

This Plugin allows you to set the LockScreen Wallpaper for BlackBerry 10 Devices (OS 10.3+).

Applies To

• Apache Cordova for BlackBerry 10

Author

• TMC Devs

Release History

• V1.0.0 - Initial release

Known Issues

• None

Including the feature in your application

This API can be installed from source:

cordova plugin add cordova-plugin-setlockscreenwallpaper

BlackBerry 10

1. BlackBerry Device software 10.3+

API Reference

//Set the imagepath (be sure to have sufficient rights, to read the Image-File)
var imagepath = "/accounts/1000/appdata/xxxxxxxxxxxxxxx/data/someImageFile.jpg"; //Start NOT with 'file://....'. The Plugin will also filter out 'file://', if you added accidentally

//Change the LockScreen Wallpaper
var result = cordova.plugins.setlockscreenwallpaper.setlockscreenwallpaper(imagepath);

console.log(result); // "success" or "error"

Notes

Be sure to have sufficient rights, to read the Image-File.

Tests

• Tested on BlackBerry Passport OS Version 10.3.2.2474
• WebWorks v2.2.0.15

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.