nativescript-brightness

A NativeScript brightness plugin for Android and iOS

APACHE-2.0 License

Downloads
7
Stars
7
Committers
8

NativeScript 7

If using 6 and below, see the following:

NativeScript Brightness

A plugin for manipulating your device's screeen brightness in NativeScript Android and iOS apps.

Installation

Run the following command from the root of your project:

tns plugin add nativescript-brightness

This command automatically installs the necessary files, as well as stores nativescript-brightness as a dependency in your project's package.json file.

This plugin requires <uses-permission android:name="android.permission.WRITE_SETTINGS"/> to be added in the android manifest.

Usage

To use the brightness module you must first require() and instantiate it:

// JavaScript
var nativescriptBrightness = require("nativescript-brightness");
var brightness = new nativescriptBrightness.Brightness();

Or if youre using TypeScript, import the module:

// TypeScript
import { Brightness } from 'nativescript-brightness';
const brightness = new Brightness();

After you have a reference to the module you can then call its get() and set() methods. For example, the code below updates you screen's brightness with an intensity setting of 25%.

The intensity can be set to a value from 1 to 100.

// TypeScript
import { Brightness } from 'nativescript-brightness';
const brightness = new Brightness();

brightness.set({
    intensity: 25
});

API

Methods

Method Description
set(options: BrightnessOptions) set screen's brightness to the desired intensity
get returns current screen brightness value as a number between 0 and 100
getNative returns current screen brightness value as returned from the native api: between 0.0 and 1.0 for iOS and 0 and 255 for android

BrightnessOptions

Property Default Description
intensity 100 defines the desired brightness value, which should be a number between 0 and 100.

License

Apache License Version 2.0, January 2004