Giter VIP home page Giter VIP logo

twilio-video-app-android's Introduction

Twilio Video Android App

CircleCI

This application demonstrates multi-party voice and video built with Twilio’s Programmable Video Android SDK.

video-app-screenshots

Features

  • Video conferencing with real-time video and audio
  • Enable/disable camera
  • Mute/unmute mic
  • Switch between front and back camera
  • Dominant speaker indicator
  • Network quality indicator

Requirements

Android Studio Version Android API Version Min
3.5+ 16

Getting Started

In order to run this application on an Android device or emulator, complete the following steps.

Deploy Twilio Access Token Server

The app requires a back-end to generate Twilio access tokens. Follow the instructions below to deploy a serverless back-end using Twilio Functions.

  1. Install Twilio CLI.
  2. Run twilio plugins:install @twilio-labs/plugin-rtc.
  3. Run twilio rtc:apps:video:deploy --authentication passcode.
  4. The passcode that is output will be used later to sign in to the app.

The passcode will expire after one week. To generate a new passcode:

  1. Run twilio rtc:apps:video:delete.
  2. Run twilio rtc:apps:video:deploy --authentication passcode.

Build

Currently there are three product flavors for the application.

  1. Internal - The application intended for internal testing and QA at Twilio. This variant can only be built by Twilions.
  2. Twilio - The application intended for every day use at Twilio. This variant can only be built by Twilions.
  3. Community - The application intended for developers interested in using Programmable Video. This variant can be built by all developers.

Building the Community Flavor

The community flavor of the application is meant for developers who would like to work with the Video Android SDK in the context of a full-fledged application.

To get started with the community flavor follow these steps:

  1. Select the communityDebug Build Variant.
  2. Run the application.

Start Video Conference

For each device:

  1. Run the app.
  2. Enter any unique name in the Your name field.
  3. Enter the passcode from Deploy Twilio Access Token Server in the Passcode field.
  4. Tap Log in.
  5. Enter a room name.
  6. Tap Join.

The passcode will expire after one week. Follow the steps below to sign in with a new passcode.

  1. Generate a new passcode.
  2. In the app tap Settings > Sign Out.
  3. Repeat the steps above.

Tests

Unit Tests

  • Android Studio - Right click and run unit tests on package app/src/main/java/com/twilio/video/app
  • Terminal - ./gradlew app:testInternalDebugUnitTest

UI Tests

UI tests require credentials that are only available to Twilio employees.

Related

For Twilions

Twilio employees should follow these instructions for internal testing.

License

Apache 2.0 license. See LICENSE.txt for details.

twilio-video-app-android's People

Contributors

kbagchigwc avatar alton09 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.