janus-java-sdk's Introduction

Janus SDK Quickstart

Janus SDK Client currently use WebSocket to connect Janus Gateway, To use it you must have Janus WebSocket URL.

How to use ?

This sdk use CompletableFuture for async tasks, for more information you can take a look to this tutorials :

Guide To CompletableFuture

1. Create JanusClient instance

var janusClient = new JanusWebSocketClient("ws://voice.kavenegar.com:8188/", new JanusEventListener() {});
janusClient.connect();

2. Create janus session

janusClient.create().thenAccept(session -> {
    logger.info("Session created , id : {}",session.getId());        
}).exceptionally(error -> {
    logger.error("Error in creating session {}",error));
    return null;
});

3. Attach a plugin into session

You can set opaque_id for accessing handle in session.

session.attach(JanusPluginType.AUDIO_BRIDGE,"OPAQUE_ID").thenAccept(handle -> {
    if(handle instanceof AudioBridgeHandle audioBridge){
        // It's audio brdige plugin instance you can call plugin requests
    }
}).exceptionally(error -> {
    logger.error("Error in attaching handle to session {}",error));
    return null;
});

For example after creating handle you can get handle by opaque_id like this :

var handle = (AudioBridgeHandle) session.mediaSession().getHandle(endpoint.getUsername()).get();

4. Execute plugin commands

handle.create(new AudioBridgeCreateRoomRequest(1012)).thenAccept(created -> {
    // room is created    
});

5. Configure Room

handle.configure(new AudioBridgeConfigureRequest(false, "OFFER_SDP")).thenAccept(answer -> {
    // answer is here
});

janus-java-sdk's People

Contributors

Stargazers

Watchers

janus-java-sdk's Issues

OSS License?

Hello, is it possible to clarify what license this software falls under? We'd like to consider it but are unclear what license applies.

Would you have a problem with applying an MIT license? I'd be happy to open up a PR if that helps.

It seems like SDP offer doesn't work.
According to other samples it is supposed to be the publish message rather than the configure message.
Either way it seems like the message is not synchronized with Janus-Gateway documentation.

Working Example ?

Hi, excellent work on the SDK , i was wodering since there is now a stable webrtc lib , for java desktop, do you have a working example for a maybe video or audio plugin as a project to improve usability further?

Recommend Projects