#Android Streaming Client

Android library that receives video streaming and plays it in an Android device
(particularly in a SurfaceView).
The current version of the code only supports RTP over UDP as the transport
protocol and decodes H264 encoded video.
As streaming server, we are using libstreaming library with some modifications
running in another Android devices.

This project contains an Android library which source code is located in the
folder android_streaming_client and an Android module that uses the library.
This module is a simple example of how to use the library and it is located in
the folder example.
You will also find several gradle files, as this is an Android Studio project
and for Android Studio users it is nice to have those files to avoid fighting
with dependencies, versions, and other project configurations.
The license_script folder includes a script to apply the license to every java
file along with the license text itself.
You can also find the LICENSE and README in the root folder of the project.

Android Streaming Client uses a libstreaming library for Android's fork
to stream video.
There is also a fork from libstreaming-examples that adds a fourth example
(look for example4 folder) to the 3 existing ones.
In order to test Android Streaming Client library you should follow this steps:

• Clone libstreaming-examples fork:

   > git clone https://github.com/ashyonline/libstreaming-examples

• Clone libstreaming fork:

   > git clone https://github.com/ashyonline/libstreaming

Keep in mind that, as libstreaming-examples uses libstreaming as a dependency,
you may want to clone libstreaming inside libstreaming-examples folder.

• Import the examples project in your favorite Android IDE.

If using Android Studio, you should import each example (example1, example2,
and so on) as a module inside an already existing project. Android Studio will
automatically create a build.gradle file for each imported module. Remember to
add the libstreaming dependency to those files.

Add the following line at the end of the corresponding build.gradle file:

   dependencies {
      compile project(':libstreaming')
   }

• Clone this repository:

   > git clone git@github.com:creativa77/AndroidStreamingClient.git

• Import Android Streaming Client project in your favorite Android IDE, also.

• Check the ip address of the client device (B) and change this line accordingly.
  

That way, the publisher (example4) will know where to stream the video.

• Run example4 in the server Android device (A).

• Run the module example from AndroidStreamingClient repository in the client
  Android device (B).

If everything works, you will be streaming video from one device (A) to another
(B) in real time.

How to simple use this library in your main activity.

   import com.c77.androidstreamingclient.lib.RtpMediaDecoder;
   
   ... 
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {

      ...
   
      // create an RtpMediaCodec with the surface view where you want 
      // the video to be shown
      RtpMediaDecoder rtpMediaDecoder = new RtpMediaDecoder(surfaceView);   
      // start it
      rtpMediaDecoder.start();
      
      ...
   }
   
   @Override
   protected void onStop() {
      
      ...
      
      // release decoder when application is stopped
      rtpMediaDecoder.release();
      
      ...
      
   }
   

Add the following line at the end of your module's build.gradle file:

dependencies {
   compile('com.creativa77:android_streaming_client:1.0.0')
}

Version number may change.

Ayelen Chavez ashi@creativa77.com.ar

Julian Cerruti jcerruti@creativa77.com.ar

Github issue tracker

This project uses code from efflux library Copyright 2010 Bruno de Carvalho,
licensed under the Apache License, Version 2.0.

Copyright 2015 Creativa77 SRL

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Contributors:

Ayelen Chavez ashi@creativa77.com.ar
Julian Cerruti jcerruti@creativa77.com.ar

Coming soon