Skip to content

Latest commit

 

History

History
218 lines (169 loc) · 7.4 KB

README.md

File metadata and controls

218 lines (169 loc) · 7.4 KB
Raw

ChromeCast API v2 for Android

This project is forked from ChromeCast Java API v2

This fork was created for adaptation to Android OS. The Google Cast SDK does not provide the ability to work with Chromecast multi-applications. If there is a need for this, you can use this library.

This project is a third party implementation of Google ChromeCast V2 protocol in java.

Install

Library is available in JitPack. Put lines below into you project's build.gradle file:

repositories {
    // ...
    maven { url 'https://jitpack.io' }
}

dependencies {
    // ...
    implementation 'com.github.thirdegg:chromecast-android-api-v2:v0.11.4'
}

Usage

This is still a work in progress. The API is not stable, the quality is pretty low and there are a lot of bugs.

To use the library, you first need to discover what Chromecast devices are available on the network.

In order to scan the network on the android you need to create multicast lock:

WifiManager.MulticastLock multicastLock;

@Override
public void onResume() {
    //...
    WifiManager wifi = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
    // get the device ip address
    final InetAddress deviceIpAddress = AndroidUtils.getDeviceIpAddress(wifi);
    multicastLock = wifi.createMulticastLock(getClass().getName());
    multicastLock.setReferenceCounted(true);
    multicastLock.acquire();
}

@Override
public void onPause() {
    //...
    if (multicastLock != null) {
        multicastLock.release();
        multicastLock = null;
    }
}

For start discovery:

ChromeCasts.startDiscovery();

Then wait until some device discovered and it will be available in list. Then device should be connected. After that one can invoke several available operations, like check device status, application availability and launch application:

ChromeCast chromecast = ChromeCasts.get().get(0);
// Connect (optional) 
// Needed only when 'autoReconnect' is 'false'. 
// Usually not needed and connection will be established automatically.
// chromecast.connect();
// Get device status
Status status = chromecast.getStatus();
// Run application if it's not already running
if (chromecast.isAppAvailable("APP_ID") && !status.isAppRunning("APP_ID")) {
    Application app = chromecast.launchApp("APP_ID");
}

To start playing media in currently running media receiver:

// play media URL directly
chromecast.load("http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4");
// play media URL with additional parameters, such as media title and thumbnail image
chromecast.load("Big Buck Bunny",           // Media title
                "images/BigBuckBunny.jpg",  // URL to thumbnail based on media URL
                "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4", // media URL
                null // media content type (optional, will be discovered automatically)
                );

Then playback may be controlled with following methods:

// pause playback
chromecast.pause();
// continue playback
chromecast.play();
// rewind (move to specified position (in seconds)
chromecast.seek(120);
// update volume
chromecast.setVolume(0.5f);
// mute
chromecast.setMuted(true);
// unmute (will set up volume to value before muting)
chromecast.setMuted(false);

Also there are utility methods to get current chromecast status (running app, etc.) and currently played media status:

Status status = chromecast.getStatus();
MediaStatus mediaStatus = chromecast.getMediaStatus();

Current running application may be stopped by calling stopApp() method without arguments:

// Stop currently running application
chromecast.stopApp();

Don't forget to close connection to ChromeCast device by calling disconnect():

// Disconnect from device
chromecast.disconnect();

Finally, stop device discovery:

ChromeCasts.stopDiscovery();

Alternatively, ChromeCast device object may be created without discovery if address of chromecast device is known:

ChromeCast chromecast = new ChromeCast("192.168.10.36");

Since v.0.9.0 there is a possibility to send custom requests using send() methods. It is required to implement at least Request interface for an objects being sent to the running application. If some response is expected then Response interface must be implemented. For example to send request to the DashCast application:

Request interface implementation

public class DashCastRequest implements Request {
    @JsonProperty
    final String url;
    @JsonProperty
    final boolean force;
    @JsonProperty
    final boolean reload;
    @JsonProperty("reload_time")
    final int reloadTime;

    private Long requestId;

    public DashCastRequest(String url,
                           boolean force,
                           boolean reload,
                           int reloadTime) {
        this.url = url;
        this.force = force;
        this.reload = reload;
        this.reloadTime = reloadTime;
    }

    @Override
    public Long getRequestId() {
        return requestId;
    }

    @Override
    public void setRequestId(Long requestId) {
        this.requestId = requestId;
    }
}

Sending request

chromecast.send("urn:x-cast:es.offd.dashcast", new DashCastRequest("http://yandex.ru", true, false, 0));

This is it for now. It covers all my needs, but if someone is interested in more methods, I am open to make improvements.

Useful links

Projects using library

License

(Apache v2.0 license)