From b185113dd291ce5d094b958c4e3d0690f4bebb9e Mon Sep 17 00:00:00 2001 From: Evgeny Zinoviev Date: Wed, 26 Dec 2018 00:00:59 +0300 Subject: write usable readme --- README.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/README.md b/README.md index d217d7f..1466f49 100644 --- a/README.md +++ b/README.md @@ -1 +1,41 @@ # mojave-permissions + +This is native nodejs module that implements access to `getMediaAccessStatus` and `askForMediaAccess` functions introduced in macOS Mojave 10.14. + +## Building + +``` +node-gyp configure +node-gyp build +``` + +And you can check if it works: +``` +node test.js +``` + +Tested on macOS 10.14 and 10.13 with nodejs 11.3.0 and Electron 1.8.8 (node 8.2.1). + +## API + +### getMediaAccessStatus(mediaType) + +**mediaType** is a string and can be `microphone` or `camera` + +Returns one of the following values: `not-determined`, `restricted`, `denied` or `granted` + +### askForMediaAccess(mediaType, callback) + +Asks user for media access and returns user choice to the callback. Example: + +``` +mojavePermissions.askForMediaAccess('camera', (granted) => { + if (!granted) { + // user has denied access to camera + } +}) +``` + +## License + +I don't care; you can use it however you want. -- cgit v1.2.3