NativeScript Call plugin
Dude, I already have a Phone app on my phone..
Sure 😅
But what if your app supports VOIP / WebRTC calls? You'll want to have the operating system pop up the native call dialog, right? That's where this plugin comes in.
Currently iOS only, where we leverage CallKit
, which is part of the iOS SDK since iOS 10.
Installation
tns plugin add nativescript-call
Demo
Check the source in the demo folder, or run it on your own device:
git clone https://github.com/EddyVerbruggen/nativescript-callcd nativescript-call/srcnpm inpm run demo.ios
Usage in NativeScript-Angular and NativeScript-Vue is nothing different from what you'd do in NativeScript-Core.
API
receiveCall
The properties you can pass to this method are:
Property | Type | Description |
---|---|---|
appName | string |
The app's name, as shown on the caller screen. Default the name of your app. |
icon | string |
The name of an icon to show for your app. Loaded from the App_Resources folder (see the demo). |
handleType | TNSCallHandleType |
Either "PHONE" (default) or "EMAIL" . |
handleId | string |
Either a phone number when handleType is "PHONE" , or an email address when handleType is "EMAIL" . |
callerName | string |
The name to be displayed on the call UI. |
hasVideo | boolean |
Whether or not this call supports video. Default false . |
supportsDTMF | boolean |
Whether the call can send DTMF (dual tone multifrequency) tones via hard pause digits or in-call keypad entries. Default false . |
The event handlers you can pass to this method are:
Name | Description |
---|---|
onSpeakerOn | Triggered when the speaker is turned on. |
onSpeakerOff | Triggered when the speaker is turned off. |
;; tnsCall.receiveCall .thenconsole.log"Receive call success" .catchconsole.log"Error receiving call: " + err;
endCall
;; tnsCall.endCall .thenconsole.log"Ended call" .catchconsole.log"Error ending call: " + err;