Android SDK Tutorial

2. You must have created an application on the Bistri Developers portal in order to get your personal API keys.

If you don’t already have a developer account, you can freely create one at the following address:

https://api.developers.bistri.com/signup

 In the ‘referrer filters’ section of your application dashboard, don’t forget to specify your application package name. For instance, ‘com.bistri.api_demo’ for Bistri demo application.

3. Create a new Android project using your favorite IDE like Android Studio or Eclipse ADT and import the library into your project.

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.CAMERA"/>
<uses-feature android:name="android.hardware.camera"/>
<uses-feature android:name="android.hardware.camera.autofocus"/>

 
You certainly want to keep your device from sleeping during a call. To do this, add the following permission:

<uses-permission android:name="android.permission.WAKE_LOCK"/>

Don’t forget to manage correctly your call screen to keep it on. For instance, you can use android:keepScreenOn="true" property in your layout, or you can set the flag FLAG_KEEP_SCREEN_ON in your code like this:

getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);

import com.bistri.api.Conference;
import com.bistri.api.Conference.*;

To get or create a bistri conference instance call, you’ll use getInstance() method.

conference = Conference.getInstance( getApplicationContext() );

 For all the following examples, “conference” shall be considered as an instance of com.bistri.api.Conference.

conference.setInfo( "38077edb" /* application ID */, "4f304359baa6d0fd1f9106aaeb116f33" /* application Key */ );

if ( conference.getStatus() == Status.DISCONNECTED ) {
    conference.connect();
}

conference.addListener( new Conference.Listener() {

    @Override
    public void onConnectionEvent(Status state) {
        // Connection status change.
    }

    @Override
    public void onError(ErrorEvent error) {
        // An error occurred.
    }

    @Override
    public void onRoomJoined(String room_name) {
        // A room as been joined.
    }

    @Override
    public void onRoomQuitted() {
        // A room as been quitted.
    }

    @Override
    public void onNewPeer(PeerStream peerStream) {
        // A new member is in room. Handle his peerStream here.
    }

    @Override
    public void onRemovedPeer(PeerStream peerStream) {
        // A member has left the room. Handle his peerStream here.
    }

    @Override
    public void onMediaStream(String peerId, MediaStream mediaStream) {
        // A mediaStream is available.
    }
});

conference.join( "test_room" );

To quit a room, use leave().

if ( conference.isInRoom() ) {
    conference.leave();
}

To know the owner of a given PeerStream, call peerStream.getId().

When a MediaStream is available, the event callback onMediaStream() of PeerStream.Handler is called.
A MediaStream contains audio and/or video.
To know if a MediaStream contains video, you can call the method hasVideo()

A MediaStream with video can be displayed by retrieving the render with getRender()

PeerStream.Handler mediaStreamHandler = new MediaStream.Handler() {
    public void onVideoRatioChange(String peer_id, MediaStream mediaStream, float ratio) {
        resizeVideos();
    }
};

PeerStream.Handler peerStreamHandler = new PeerStream.Handler() {
    public void onMediaStream( String peer_id, MediaStream mediaStream ) {
        if ( !mediaStream.hasVideo() ) {
            return;
        }
        mediaStream.setHandler( mediaStreamHandler );
        View renderView = mediaStream.getRender();
        // Add the render view into your video layout ( A layout of your choice )
        videoLayout.addView( renderView );
    }
};

@Override
public void onNewPeer(PeerStream peerStream) {
    // A new member is in room. Handle his peerStream here.
    peerStream.setHandler( peerStreamHandler );
}

When the DataStream is got, don’t forget to set an handler ( using setHandler ). This allow you to be informed when data is received or if the status has changed.
Send data using send method.
Close the DataStream using close.

 See documentation for more details about DataStream

// Open a DataStream
DataStream dataStream = peerStream.openDataChannel( "TEST" );
dataStream.setHandler( new DataStream.Handler() {
        @Override
        public void onOpen(DataStream myself) {
            Log.d( "DataStream.Handler", "onOpen" );
        }

        @Override
        public void onMessage(DataStream myself, ByteBuffer message, boolean binary) {
            Log.d( "DataStream.Handler", "onMessage length:" + message.capacity() );

            if ( !binary ) {
                byte[] b = new byte[message.remaining()];
                message.get(b);
                Log.d( "DataStream.Handler", "message:" + new String(b) );
            }
        }

        @Override
        public void onClose(DataStream myself) {
            Log.d( " DataStream.Handler", "onClose" );
        }

        @Override
        public void onError(DataStream myself, String error) {
            Log.d( " DataStream.Handler", "onError : " + error );
        }
} );

[...]
// Send data
dataStream.send( "Hello world" );

[...]
// Close DataStream
dataStream.close();

 See documentation for more details about available options

conference.setVideoOption( VideoOption.MAX_WIDTH, 320 );
conference.setVideoOption( VideoOption.MAX_HEIGHT, 240 );
conference.setVideoOption( VideoOption.MAX_FRAME_RATE, 15 );

conference.setAudioOption( AudioOption.PREFERRED_CODEC, AudioCodec.ISAC );
conference.setAudioOption( AudioOption.PREFERRED_CODEC_CLOCKRATE, 16000 );

// Loudspeaker status member
private boolean loudspeaker = true;

[...]
public void toggleLoudspeaker(){
    loudspeaker = !loudspeaker; // Toggle status
    conference.setLoudspeaker( loudspeaker );
}