• Stars
    star
    184
  • Rank 209,187 (Top 5 %)
  • Language
    Java
  • License
    MIT License
  • Created about 8 years ago
  • Updated about 1 month ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Quickstart app for the Voice Android SDK

Twilio Voice Quickstart for Android

NOTE: This sample application uses the Programmable Voice Android 6.x APIs. If you are using prior versions of the SDK, we highly recommend planning your migration to the latest version as soon as possible.

Get started with Voice on Android

  • Quickstart - Run the quickstart app
  • Examples - Customize your voice experience with these examples

References

Voice Android SDK Versions

Quickstart

To get started with the Quickstart application follow these steps. Steps 1-5 will enable the application to make a call. The remaining steps 7-10 will enable the application to receive incoming calls in the form of push notifications using FCM.

  1. Generate google-services.json
  2. Open this project in Android Studio
  3. Use Twilio CLI to deploy access token and TwiML application to Twilio Serverless
  4. Create a TwiML application for the access token
  5. Generate an access token for the quickstart
  6. Run the app
  7. Create a Push Credential using your FCM Server API Key
  8. Receive an incoming call
  9. Make client to client call
  10. Make client to PSTN call

1. Generate google-services.json

The Programmable Voice Android SDK uses Firebase Cloud Messaging push notifications to let your application know when it is receiving an incoming call. If you want your users to receive incoming calls, youโ€™ll need to enable FCM in your application.

Follow the steps under Use the Firebase Assistant in the Firebase Developers Guide. Once you connect and sync to Firebase successfully, you will be able to download the google-services.json for your application.

Login to Firebase console and make a note of generated Server Key. You will need them in step 7.

Make sure the generated google-services.json is downloaded to the app directory of the quickstart project to replace the existing app/google-services.json stub json file. If you are using the Firebase plugin make sure to remove the stub google-services.json file first.

Missing valid google-services.json will result in a build failure with the following error message : "

2. Open the project in Android Studio

3. Use Twilio CLI to deploy access token and TwiML application to Twilio Serverless

You must have the following installed:

  • Node.js v10+
  • NPM v6+ (comes installed with newer Node versions)

Run npm install to install all dependencies from NPM.

Install twilio-cli with:

$ npm install -g twilio-cli

Login to the Twilio CLI. You will be prompted for your Account SID and Auth Token, both of which you can find on the dashboard of your Twilio console.

$ twilio login

Once successfully logged in, an API Key, a secret get created and stored in your keychain as the twilio-cli password in SKxxxx|secret format. Please make a note of these values to use them in the Server/.env file.

This app requires the Serverless plug-in. Install the CLI plugin with:

$ twilio plugins:install @twilio-labs/plugin-serverless

Before deploying, create a Server/.env by copying from Server/.env.example

$ cp Server/.env.example Server/.env

Update Server/.env with your Account SID, auth token, API Key and secret.

ACCOUNT_SID=ACxxxx
AUTH_TOKEN=xxxxxx
API_KEY_SID=SKxxxx
API_SECRET=xxxxxx
APP_SID=APxxxx(available in step 4)
PUSH_CREDENTIAL_SID=CRxxxx(available in step 7)

The Server folder contains a basic server component which can be used to vend access tokens or generate TwiML response for making call to a number or another client. The app is deployed to Twilio Serverless with the serverless plug-in:

$ cd Server
$ twilio serverless:deploy

The server component that's baked into this quickstart is in Node.js. If youโ€™d like to roll your own or better understand the Twilio Voice server side implementations, please see the list of starter projects in the following supported languages below:

Follow the instructions in the project's README to get the application server up and running locally and accessible via the public Internet.

4. Create a TwiML application for the Access Token

Next, we need to create a TwiML application. A TwiML application identifies a public URL for retrieving TwiML call control instructions. When your QS app makes a call to the Twilio cloud, Twilio will make a webhook request to this URL, your application server will respond with generated TwiML, and Twilio will execute the instructions youโ€™ve provided.

Use Twilio CLI to create a TwiML app with the make-call endpoint you have just deployed

$ twilio api:core:applications:create \
    --friendly-name=my-twiml-app \
    --voice-method=POST \
    --voice-url="https://my-quickstart-dev.twil.io/make-call"

You should receive an Appliciation SID that looks like this

APxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

5. Generate an access token for the quickstart

Install the token plug-in

$ twilio plugins:install @twilio-labs/plugin-token

Use the TwiML App SID you just created to generate an access token

$ twilio token:voice --identity=alice --voice-app-sid=APxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Copy the access token string. Your Android app will use this token to connect to Twilio.

6. Run the app

Now letโ€™s go back to the app, update the placeholder of accessToken with access token string you just copied in VoiceActivity.java.

 private String accessToken = "PASTE_YOUR_ACCESS_TOKEN_HERE";

Build and run the quickstart app on an Android device.

Press the call button to open the call dialog.

Leave the dialog text field empty and press the call button to start a call. You will hear the congratulatory message. Support for dialing another client or number is described in steps 9 and 10.

7. Create a Push Credential using your FCM Server Key

You will need to store the FCM Server key(The Server key of your project from the Firebase console, found under Settings/Cloud messaging) with Twilio so that we can send push notifications to your app on your behalf. Once you store the Server key with Twilio, it will get assigned a Push Credential SID so that you can later specify which key we should use to send push notifications.

Use Twilio CLI to create a Push Credential using the FCM Server Key.

$ twilio api:chat:v2:credentials:create \
    --type=fcm \
    --friendly-name="voice-push-credential-fcm" \
    --secret=SERVER_KEY_VALUE

This will return a Push Credential SID that looks like this

CRxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Now let's generate another access token and add the Push Credential to the Voice Grant.

$ twilio token:voice \
    --identity=alice \
    --voice-app-sid=APxxxx \
    --push-credential-sid=CRxxxxs

8. Receiving an Incoming Notification

You are now ready to receive incoming calls. Update your app with the access token generated from step 7 and rebuild your app. The Voice.register() method will register your mobile application with the FCM device token as well as the access token. Once registered, hit your application server's /place-call endpoint: https://my-quickstart-dev.twil.io/place-call?to=alice. This will trigger a Twilio REST API request that will make an inbound call to your mobile app.

Your application will be brought to the foreground and you will see an alert dialog. The app will be brought to foreground even when your screen is locked.

"

Once your app accepts the call, you should hear a congratulatory message.

9. Make client to client call

To make client to client calls, you need the application running on two devices. To run the application on an additional device, make sure you use a different identity in your access token when registering the new device.

Press the call button to open the call dialog.

Enter the client identity of the newly registered device to initiate a client to client call from the first device.

10. Make client to PSTN call

A verified phone number is one that you can use as your Caller ID when making outbound calls with Twilio. This number has not been ported into Twilio and you do not pay Twilio for this phone number.

To make client to number calls, first get a valid Twilio number to your account via https://www.twilio.com/console/phone-numbers/verified. Update your server code and replace the callerNumber with the verified number. Restart the server so that it uses the new value.

Press the call button to open the call dialog.

Enter a PSTN number and press the call button to place a call.

Examples

In addition to the quickstart we've also added an example that shows how to create and customize media experience in your app:

  • Custom Audio Device - Demonstrates how to use Twilio's Programmable Voice SDK with audio playback and recording functionality provided by a custom AudioDevice.

More Documentation

You can find more documentation on getting started as well as our latest Javadoc below:

Twilio Helper Libraries

To learn more about how to use TwiML and the Programmable Voice Calls API, check out our TwiML quickstarts:

Issues and Support

Please file any issues you find here on Github. For general inquiries related to the Voice SDK you can file a support ticket. Please ensure that you are not sharing any Personally Identifiable Information(PII) or sensitive account information (API keys, credentials, etc.) when reporting an issue.

License

MIT

More Repositories

1

twilio-video-app-react

A collaboration application built with the twilio-video.js SDK and React.js
TypeScript
1,808
star
2

twilio-python

A Python module for communicating with the Twilio API and generating TwiML.
Python
1,707
star
3

stashboard

An open-source status dashboard running on App Engine
Python
1,594
star
4

twilio-php

A PHP library for communicating with the Twilio REST API and generating TwiML.
PHP
1,447
star
5

twilio-ruby

A Ruby gem for communicating with the Twilio API and generating TwiML
Ruby
1,335
star
6

twilio-node

Node.js helper library
TypeScript
1,304
star
7

OpenVBX

OpenVBX is a web-based open source phone system for business.
PHP
699
star
8

twilio-csharp

Twilio C#/.NET Helper Library for .NET Framework 3.5+ and supported .NET Core versions
C#
636
star
9

BankersBox

redis-like wrapper for javascript storage
CoffeeScript
571
star
10

twilio-video.js

Twilioโ€™s Programmable Video JavaScript SDK
JavaScript
569
star
11

video-quickstart-ios

Twilio Video Quickstart for iOS
Swift
458
star
12

twilio-java

A Java library for communicating with the Twilio REST API and generating TwiML.
Java
440
star
13

video-quickstart-js

A quickstart and code samples for Twilio Video JavaScript SDK. https://www.twilio.com/docs/video
JavaScript
390
star
14

shadow

A HTTP debugging proxy that helps you with your continuous deployments
JavaScript
330
star
15

twilio-go

A Go package for communicating with the Twilio API.
Go
278
star
16

twilio-sans-mono

Twilio Sans Mono is a beautiful and extensive open source programming font
Shell
255
star
17

twilio-video-app-ios

A collaboration application built with the Twilio Video iOS SDK
Swift
246
star
18

authy-php

A PHP client for Authy
PHP
245
star
19

twilio-video-app-android

A collaboration application built with the Twilio Video Android SDK
Kotlin
240
star
20

video-quickstart-android

Twilio Video Quickstart for Android
Java
210
star
21

authy-devise

Authy Devise plugin to add Two-Factor Authentication
Ruby
201
star
22

authy-python

Authy API Client for Python
Python
189
star
23

twilio-salesforce

A Salesforce/Force.com library for communicating with the Twilio REST API and generating TwiML. Need help? Post your questions to http://getsatisfaction.com/twilio or email us at [email protected]
Apex
186
star
24

voice-quickstart-ios

Twilio Voice Quickstart for iOS with Swift
Objective-C
179
star
25

twilio-cli

Unleash the power of Twilio from your command prompt
JavaScript
160
star
26

audioswitch

An Android audio management library for real-time communication apps.
Kotlin
159
star
27

authy-ruby

**Deprecated** Ruby library to access the authy API
Ruby
156
star
28

authy-openvpn

Authy Open VPN Two-Factor Authentication
C
152
star
29

gameday

A collection of Twilio SRE's Gameday Templates
140
star
30

twilio-oai

The Twilio OpenAPI Specification
Makefile
122
star
31

TwilioChatJsReactNative

ReactNative app example for Twilio Programmable Chat with working iOS and Android push messages https://www.twilio.com/chat
JavaScript
114
star
32

chessms

Play Chess over SMS!
Erlang
112
star
33

media-streams

Quick start guides for configuring and consuming Twilio Media Streams
Ruby
102
star
34

twilio-conversations-demo-react

Twilio Conversations Demo Web Application
TypeScript
97
star
35

apkscale

A Gradle plugin to measure the app size impact of Android libraries
Kotlin
93
star
36

OpenVBX-iPhone

OpenVBX for iPhone
Objective-C
92
star
37

twilio-chat-demo-js

Programmable Chat API Demo Application for JavaScript
JavaScript
92
star
38

starter-node

A starter app for node.js developers embarking on their first Twilio quest!
JavaScript
84
star
39

authy-form-helpers

Authy javascripts and css file to help create quick forms for the authy api
CoffeeScript
83
star
40

flex-plugin-builder

Packages related to building a Twilio Flex Plugin
TypeScript
83
star
41

starter-python

A starter app for Python developers embarking on their first Twilio quest!
CSS
76
star
42

sourd.io

sourd.io: temperature, humidity, and rise monitoring for your sourdough starter
C++
73
star
43

twilio-voice-react-native

TypeScript
67
star
44

twilio-client.js

Twilioโ€™s Programmable Voice JavaScript SDK
TypeScript
67
star
45

authy-java

Java Client for Twilio Authy Two-Factor Authentication (2FA) API
Java
65
star
46

twilio-video-ios

Programmable Video SDK by Twilio
Swift
64
star
47

twilio-chat-demo-android

Chat API Demo Application for Android
Kotlin
63
star
48

twilio-webchat-react-app

Twilio Webchat React App is an application that demonstrates a website chat widget built with Twilio's Conversations JS SDK, Twilio Paste Design library and Create React App.
TypeScript
63
star
49

terraform-provider-twilio

Terraform Twilio provider
Go
62
star
50

twilio-voice.js

Twilio's JavaScript Voice SDK
TypeScript
50
star
51

twilio-webrtc.js

WebRTC-related APIs and shims used by twilio-video.js
JavaScript
49
star
52

rtc-diagnostics

TypeScript
44
star
53

flex-ui-sample

Twilio Flex UI Sample
JavaScript
44
star
54

twilio-video-diagnostics-react-app

A diagnostics tool that tests a participant's ability to have a quality video call. Built with the twilio-video.js SDK, RTC Diagnostics SDK, and React.js.
TypeScript
41
star
55

wiztowar

Build WARs from your Dropwizard apps
Java
40
star
56

hackathons

A collection of tips and tricks for using Twilio at hackathons
40
star
57

twilio-voice-ios

Programmable Voice SDK by Twilio
Swift
39
star
58

voice-quickstart-objc

Twilio Voice Quickstart for iOS with Objective-C
Objective-C
38
star
59

twilio-voice-notification-app

Reference app built in ReactJS that demonstrates how to leverage Twilio Programmable Voice and Twilio SDKs to create a voice notification system.
TypeScript
36
star
60

sample-code

Auto-generated code samples for the Twilio REST API
Java
35
star
61

draw-with-twilio

Draw with Twilio
JavaScript
35
star
62

video-quickstart-objc

Twilio Video Quickstart for iOS with Objective-C
Objective-C
33
star
63

twilio-video-processors.js

Twilio Video Processors is a collection of video processing tools which can be used with Twilio Video JavaScript SDK to apply transformations and filters to a video track.
TypeScript
33
star
64

twilio-voice-react-native-app

TypeScript
32
star
65

TwilioChatXamarinBindings

Twilio Chat Bindings for Xamarin (Android and iOS) and Sample app with working FCM and APN pushes using those bindings.
C#
32
star
66

flex-webchat-ui-sample

Twilio Flex Web Chat UI Sample
JavaScript
31
star
67

twilio-live-interactive-video

An interactive live video app built with Twilio Live and Twilio Video
TypeScript
31
star
68

twilio-video.js-recording-bot

JavaScript
30
star
69

twilio-chat-demo-ios

Twilio Programmable Chat Demo Application for iOS
Objective-C
28
star
70

calcite-kudu

Apache Calcite Adapter for Apache Kudu
Java
28
star
71

ortc-adapter

ORTC to WebRTC Adapter
JavaScript
28
star
72

cloudsec

27
star
73

starter-ruby

A starter app for Ruby developers embarking on their first Twilio quest!
JavaScript
27
star
74

twilio-oai-generator

Twilio OpenAPI client generator
Java
26
star
75

autopilot-cli

The Twilio Autopilot CLI is now deprecated. Please use the Autopilot Plugin for the Twilio CLI here https://www.twilio.com/docs/autopilot/twilio-autopilot-cli
JavaScript
26
star
76

voice-quickstart-server-python

Python
25
star
77

twilio-taskrouter.js

JS SDK v2 for Twilio's TaskRouter skills based routing system.
JavaScript
24
star
78

twilio-boost-build

Build tool for boost libraries on android, ios, linux and osx
Shell
24
star
79

wireless-security-camera

Create a Twilio-powered device that keeps watch over dangerous and remote locations and alerts stakeholders of intrusions or safety concerns.
CSS
24
star
80

twilio-video-room-monitor.js

A browser-based tool that displays information and metrics about Twilio Video JavaScript applications
TypeScript
24
star
81

video-shared-arkit-sample

ARKit + Twilio Video Data Tracks demo
Swift
24
star
82

voice-quickstart-server-node

voice quickstart server example in node
JavaScript
24
star
83

starter-java

A starter app for Java developers embarking on their first Twilio quest!
CSS
22
star
84

wireless-fleet-tracker

Create a Twilio-powered Fleet Tracker that uses off-the-shelf components to track and log: miles driven, hours of uptime and downtime, locations, average speed, and fuel consumption.
CSS
22
star
85

voices

Twilio Voices - Contribute programming tutorials to the Twilio blog. Get paid for each post you publish.
20
star
86

rtc-diagnostics-react-app

TypeScript
20
star
87

autopilot-templates

JavaScript
19
star
88

client-js-1.4-examples

Examples for using the new Client JS 1.4 Audio functionality
JavaScript
19
star
89

wp-click2call

Wordpress Plugin for Click2Call
PHP
19
star
90

authy.net

.NET Library to access the Authy API
C#
19
star
91

starter-php

A starter app for PHP developers embarking on their first Twilio quest!
PHP
19
star
92

Breakout_Arduino_Library

C
18
star
93

howtos

Sample applications that cover common use cases in a variety of languages.
Python
18
star
94

twilio-conversations-demo-android-kotlin

An application demonstrating use of Twilio Conversations on Android - this is a full working Kotlin application
Kotlin
18
star
95

cerebro

Python
17
star
96

linkit-one-sensor-samples

Samples for the LinkIt ONE Starter Kit
C++
17
star
97

twilio-flex-token-validator

Flex JWE Token Validator
TypeScript
17
star
98

wireless-postman-collection

This repository includes a group of Programmable Wireless HTTP requests for your convenience. You can learn more about Programmable Wireless HTTP request formats in the Programmable Wireless Documentation.
17
star
99

twilio-verify-ios

Twilio Verify Push SDK helps you verify users by adding a low-friction, secure, cost-effective, "push verification" factor into your own apps. This project provides an SDK to implement Verify Push for your iOS app.
Swift
17
star
100

twilio-conversations-demo-ios-swift

Twilio Conversations for iOS Demo application in Swift
Swift
17
star