npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

cordova-plugin-voiceit-api-2

v1.0.4

Published

This plugin is a Cordova VoiceIt plugin that encapsulates VoiceIt's Face and Voice Verification API

Downloads

28

Readme

An Apache Cordova plugin that lets you easily integrate VoiceIt's Face and Voice Verification API into your Cordova Based iOS and Android apps.

For more information on VoiceIt API 2 and its features, see the website and documentation for expected JSON responses.

Supported Platforms

  • Android
  • iOS

Getting Started

To use the VoiceIt Cordova Plugin in your Cordova Project, if you haven't already, please Sign Up for a free Developer Id at voiceit.io/signup. Then in the settings page, you should now be able view the API Key and Token (as shown below).

Installation

First please cd into your Cordova App's root directory via the terminal/command line and then run the following command (feel free to change the microphone and camera usage description below before running the command):

$ cordova plugin add cordova-plugin-voiceit-api-2 --variable MICROPHONE_USAGE_DESCRIPTION="This app needs to access to your microphone for voice biometrics" --variable CAMERA_USAGE_DESCRIPTION="This app needs to access to your camera for face biometrics"

API Calls

Here are code snippets that show you how you can call the Various VoiceIt API 2 API calls inside of your Cordova Project JavaScript Files.

Initialization

Initialize a variable as the reference to VoiceIt API 2, passing in the API Key and Token from the settings page, and optionally a hexadecimal theme color to match your app.

var myVoiceIt = new VoiceItAPITwo({ apiKey : 'API_KEY_HERE', apiToken: 'API_TOKEN_HERE', themeColor: '#FBC132'});

Get all Users

To get all users for the apiKey call the getAllUsers function like this with no parameters:

myVoiceIt.getAllUsers(function(jsonResponse) {
    console.log("All users for developer :");
    jsonResponse.users.forEach(function(user){
      console.log(user.userId + ',');
    });
});

Get Phrases

To get phrases for the apiKey call getPhrases, padding the contentLanguage

myVoiceIt.getPhrases({
  contentLanguage: "CONTENT_LANGUAGE_HERE"
},function(jsonResponse) {
    console.log("All phrases for developer :");
    jsonResponse.phrases.forEach(function(phrase){
      console.log(phrase.text + ',');
    });
});

Create User

To create a new user call the createUser function like this with no parameters:

myVoiceIt.createUser(function(jsonResponse) {
    console.log("User created with userId : " + jsonResponse.userId);
});

Check User Exists

To check if a user exists call checkUserExists, passing the userId:

myVoiceIt.checkUserExists({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log("User exists : " + jsonResponse.exists);
});

Get Groups for User

To get groups that the user belongs to call getGroupsForUser, passing the userId:

myVoiceIt.getGroupsForUser({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log("Groups for user :");
  jsonResponse.groups.forEach(function(groupId){
    console.log(groupId + ',');
  });
});

Delete User

To delete a user call deleteUser, passing the userId:

myVoiceIt.deleteUser({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Get all Groups

To get all groups for the apiKey call the getAllGroups function like this with no parameters:

myVoiceIt.getAllGroups(function(jsonResponse) {
    console.log("All groups for developer :");
    jsonResponse.groups.forEach(function(group){
      console.log(group.groupId + ',');
    });
});

Get Group

To get a group's details call getGroup, passing the groupId:

myVoiceIt.getGroup({
  groupId: "GROUP_ID_HERE"
}, function(jsonResponse) {
    console.log(jsonResponse);
});

Group Exists

To check if a group exists call groupExists, passing the groupId:

myVoiceIt.groupExists({
  groupId: "GROUP_ID_HERE"
}, function(jsonResponse) {
    console.log("Group exists : ",jsonResponse.exist);
});

Create Group

To create a new group call the createGroup function like this with no parameters:

myVoiceIt.createGroup(function(jsonResponse) {
        console.log("Group created with groupId : " + jsonResponse.groupId);
});

Add User to Group

To add a user to a group call the addUserToGroup function, passing the groupId and userId:

myVoiceIt.addUserToGroup({
  userId:"USER_ID_HERE", groupId: "GROUP_ID_HERE"
}, function(jsonResponse) {
        console.log("User added to group: " + jsonResponse);
});

Remove User from Group

To remove a user from a group call the removeUserFromGroup function, passing the groupId and userId:

myVoiceIt.removeUserFromGroup({
  userId:"USER_ID_HERE", groupId: "GROUP_ID_HERE"
}, function(jsonResponse) {
        console.log("User removed from group: " + jsonResponse);
});

Delete Group

To delete a group call deleteGroup, passing the groupId:

myVoiceIt.deleteGroup({
  groupId: "GROUP_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Get all Voice Enrollments

To get all voice enrollments for a user call getAllVoiceEnrollments, passing the userId:

myVoiceIt.getAllVoiceEnrollments({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log("All voice enrollments for user :");
  jsonResponse.voiceEnrollments.forEach(function(enrollment){
    console.log(enrollment.voiceEnrollmentId + ',');
  });
});

Get all Face Enrollments

To get all face enrollments for a user call getAllFaceEnrollments, passing the userId:

myVoiceIt.getAllFaceEnrollments({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log("All face enrollments for user :");
  jsonResponse.faceEnrollments.forEach(function(enrollment){
    console.log(enrollment.faceEnrollmentId + ',');
  });
});

Get all Video Enrollments

To get all video enrollments for a user call getAllVideoEnrollments, passing the userId:

myVoiceIt.getAllVideoEnrollments({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log("All video enrollments for user :");
  jsonResponse.videoEnrollments.forEach(function(enrollment){
    console.log(enrollment.videoEnrollmentId + ',');
  });
});

Delete Voice Enrollment

To delete a voice enrollment call deleteVoiceEnrollment, passing the userId and voiceEnrollmentId parameters:

myVoiceIt.deleteEnrollment({
  userId: "USER_ID_HERE",
  voiceEnrollmentId:"VOICE_ENROLLMENT_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Delete Face Enrollment

To delete a face enrollment call deleteFaceEnrollment, passing the userId and faceEnrollmentId parameters:

myVoiceIt.deleteFaceEnrollment({
  userId: "USER_ID_HERE",
  faceEnrollmentId:"FACE_ENROLLMENT_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Delete Video Enrollment

To delete a video enrollment call deleteVideoEnrollment, passing the userId and videoEnrollmentId parameters:

myVoiceIt.deleteVideoEnrollment({
  userId: "USER_ID_HERE",
  videoEnrollmentId:"VIDEO_ENROLLMENT_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Delete All Voice Enrollments

To delete all voice enrollments call deleteAllVoiceEnrollments, passing the userId:

myVoiceIt.deleteAllVoiceEnrollments({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Delete All Face Enrollments

To delete all face enrollments call deleteAllFaceEnrollments, passing the userId:

myVoiceIt.deleteAllFaceEnrollments({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Delete All Face Enrollments

To delete all video enrollments call deleteAllVideoEnrollments, passing the userId:

myVoiceIt.deleteAllVideoEnrollments({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Delete All Enrollments

To delete all voice,face and video enrollments for a user call deleteAllEnrollments, passing the userId:

myVoiceIt.deleteAllEnrollments({
  userId: "USER_ID_HERE"
}, function(jsonResponse) {
  console.log(jsonResponse);
});

Encapsulated Voice Enroll User

To enroll a user's voice, call the encapsulatedVoiceEnrollUser function, passing the userId, contentLanguage, and phrase ( make sure you use an approved phrase for your developer account at https://voiceit.io/phraseManagement) parameters. This method includes the UI and walks the user through three successful voice enrollments before returning.

myVoiceIt.encapsulatedVoiceEnrollUser({
  userId: "USER_ID_HERE",
  contentLanguage:"en-US",
  phrase:"my face and voice identify me"
}, function() {
  console.log("User cancelled enrollments");
}, function() {
  console.log("User successfully completed enrolling");
});

Encapsulated Face Enroll User

To enroll a user's face, call the encapsulatedFaceEnrollUser function passing the userId to enroll. This method includes the UI and walks the user through a successful face enrollment before returning;

myVoiceIt.encapsulatedFaceEnrollUser({
  userId: "USER_ID_HERE"
}, function() {
  console.log("User cancelled face enrollment");
}, function() {
  console.log("User successfully completed enrolling");
});

Encapsulated Video Enroll User

To enroll a user's face and voice, call the encapsulatedVideoEnrollUser function, passing the userId, contentLanguage, and phrase ( make sure you use an approved phrase for your developer account at https://voiceit.io/phraseManagement) parameters. This method includes the UI and walks the user through three successful enrollments before returning.

myVoiceIt.encapsulatedVideoEnrollUser({
  userId: "USER_ID_HERE",
  contentLanguage:"en-US",
  phrase:"my face and voice identify me"
}, function() {
  console.log("User cancelled enrollments");
}, function() {
  console.log("User successfully completed enrolling");
});

Encapsulated Voice Verification

To verify a user's voice, call the encapsulatedVoiceVerification function, passing the userId, contentLanguage, and phrase (make sure you use an approved phrase for your developer account at https://voiceit.io/phraseManagement) parameters. This method includes the UI for voice verification and returns the voice confidence.

myVoiceIt.encapsulatedVoiceVerification({
  userId: "USER_ID_HERE",
  contentLanguage:"en-US",
  phrase:"my face and voice identify me"
}, function() {
  console.log("User cancelled verifications");
}, function(jsonResponse) {
  console.log("User successfully completed verification with voiceConfidence : " + jsonResponse.voiceConfidence);
});

Encapsulated Face Verification

To verify a user's face call the encapsulatedFaceVerification function, passing the userId and doLivenessDetection parameters. doLivenessDetection is a boolean that makes the user attempt liveness challenges, such as smiling, blinking, moving their face left/right for enhanced security. This method includes the UI for face verification and returns the face confidence.

myVoiceIt.encapsulatedFaceVerification({
  userId: "USER_ID_HERE",
  doLivenessDetection: true
}, function() {
  console.log("User cancelled verifications");
}, function(jsonResponse) {
  console.log("User successfully completed verification with faceConfidence : " + jsonResponse.faceConfidence);
});

Encapsulated Video Verification

To verify a user's face and voice, call the encapsulatedVideoVerification function, passing the userId, contentLanguage, phrase( make sure you use an approved phrase for your developer account at https://voiceit.io/phraseManagement) and doLivenessDetection parameters. doLivenessDetection is a boolean that makes the user attempt liveness challenges, such as smiling, blinking, moving their face left/right for enhanced security. This method includes the UI for face and voice verification and returns the face and voice confidence.

myVoiceIt.encapsulatedVideoVerification({
  userId: "USER_ID_HERE",
  contentLanguage:"en-US",
  phrase:"my face and voice identify me",
  doLivenessDetection: true
}, function() {
  console.log("User cancelled verifications");
}, function(jsonResponse) {
  console.log("User successfully completed verification with faceConfidence : " + jsonResponse.faceConfidence + " and  voiceConfidence : " + jsonResponse.voiceConfidence);
});

Encapsulated Voice Identification

To identify a user's voice, call the encapsulatedVoiceIdentification function, passing the groupId, contentLanguage, and phrase (make sure you use an approved phrase for your developer account at https://voiceit.io/phraseManagement) parameters. This method includes the UI for voice identification and returns the voice confidence.

myVoiceIt.encapsulatedVoiceIdentification({
  groupId: "GROUP_ID_HERE",
  contentLanguage:"en-US",
  phrase:"my face and voice identify me"
}, function() {
  console.log("User cancelled identification");
}, function(jsonResponse) {
  console.log("User successfully completed identification with voiceConfidence : " + jsonResponse.voiceConfidence);
});

Encapsulated Face Identification

To identify a user's face call the encapsulatedFaceIdentification function, passing the groupId and doLivenessDetection parameters. doLivenessDetection is a boolean that makes the user attempt liveness challenges, such as smiling, blinking, moving their face left/right for enhanced security. This method includes the UI for face identification and returns the face confidence.

myVoiceIt.encapsulatedFaceIdentification({
  groupId: "GROUP_ID_HERE",
  doLivenessDetection: true
}, function() {
  console.log("User cancelled identification");
}, function(jsonResponse) {
  console.log("User successfully completed identification with faceConfidence : " + jsonResponse.faceConfidence);
});

Encapsulated Video Identification

To identify a user's face and voice out of a group, call the encapsulatedVideoIdentification function, passing the groupId, contentLanguage, phrase( make sure you use an approved phrase for your developer account at https://voiceit.io/phraseManagement) and doLivenessDetection parameters. doLivenessDetection is a boolean that makes the user attempt liveness challenges, such as smiling, blinking, moving their face left/right for enhanced security. This method includes the UI for face and voice identification and returns the face and voice confidence.

myVoiceIt.encapsulatedVideoIdentification({
  groupId: "USER_ID_HERE",
  contentLanguage:"en-US",
  phrase:"my face and voice identify me",
  doLivenessDetection: true
}, function() {
  console.log("User cancelled identification");
}, function(jsonResponse) {
  console.log("User " + jsonResponse.userId + " was successfully identified with faceConfidence : " + jsonResponse.faceConfidence + " and  voiceConfidence : " + jsonResponse.voiceConfidence);
});

Authors

Cordova

armaanbindra, [email protected]

iOS

armaanbindra, [email protected]

Android

stephenakers, [email protected]

License

Cordova Plugin VoiceIt API 2 is available under the GNU GENERAL PUBLIC LICENSE. See the LICENSE file for more info.