thedavidbox-client4j is a Java HTTP client for consuming TheDavidBox Service API on Networked Media Tank devices such as Popcorn Hour A200, A210, A300, A400, A410, C200, C300, PopBox 3D, PopBox V8 based in NMT system
java 1.5+
The latest thedavidbox-client4j artifacts are published to maven central. Bringing thedavidbox-client4j into your project should be as simple as adding the following to your maven pom.xml file:
<dependencies>
<dependency>
<groupId>com.vikingbrain</groupId>
<artifactId>thedavidbox-client4j</artifactId>
<version>1.2.1</version> <!-- or whatever the latest version is -->
</dependency>
</dependencies> <!-- Maven dependency for an Android application project -->
<dependencies>
<dependency>
<groupId>com.vikingbrain</groupId>
<artifactId>thedavidbox-client4j</artifactId>
<version>1.2.1</version> <!-- or whatever the latest version is -->
<exclusions>
<exclusion>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpcore</artifactId>
</exclusion>
<exclusion>
<groupId>stax</groupId>
<artifactId>stax</artifactId>
</exclusion>
<exclusion>
<groupId>stax</groupId>
<artifactId>stax-api</artifactId>
</exclusion>
<exclusion>
<groupId>xpp3</groupId>
<artifactId>xpp3</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>##Downloads:
- thedavidbox-client4j-1.2.1-jar-with-dependencies.jar (All required dependencies attached)
- thedavidbox-client4j-1.2.1-android.jar (Ready to use on your Android app)
- thedavidbox-client4j-1.2.1-sources.jar
- thedavidbox-client4j-1.2.1-javadoc.jar
- thedavidbox-client4j-1.2.1.jar (Wihout dependencies)
Creating a client:
/** Create a client with default client options */
TheDavidBoxClient theDavidBoxClient = new TheDavidBoxClientImpl("IPorHostName");
/** Create a client with your custom default client options */
ClientOptions clientOptions = new ClientOptions.Builder()
.defaultRotationDegree(RotationDegree.ROTATION_270) //override default
.defaultSlideInterval(23) //override default
.defaultDisplayMode(DisplayMode.SHOW) //override default
...
.build();
TheDavidBoxClient theDavidBoxClient = new TheDavidBoxClientImpl("IPorHostName",
clientOptions);The thedavidbox-client4j operations are divided in ten modules: ModuleDownloadManager, ModuleDeployment, ModuleFile, ModuleNetworkBrowse, ModulePlayback, ModuleSetting, ModuleSystem, ModuleMetadata, ModuleMetadataDatabase, ModuleUpnp.
Create and execute an operation from a module:
//Get the module for the operation
ModulePlayback modulePlayback = theDavidBoxClient.getModulePlayback();
String audioPath = "file:///opt/sybhttpd/localhost.drives/SATA_DISK/music/mock.mp3";
/** Operation start audio on NMT. It is built using the DisplayMode specified in your
default client options so you don't need to specify it every time. */
modulePlayback.buildStartAodOperation(audioPath).execute();
/** Or redefine the attributes for the operation at any time */
StartAodOperation startAodOperation = modulePlayback.buildStartAodOperation(audioPath);
startAodOperation.setDisplayMode(DisplayMode.HIDE); //background mode
startAodOperation.execute();
//Other operation examples
CreateDownloadTaskOperation operation = theDavidBoxClient.getModuleDownloadManager().
buildCreateDownloadTaskOperation("http://movie.torrent", "MovieName");
ListNetworkResourceOperation operation = theDavidBoxClient.getModuleNetworkBrowse().
buildListNetworkResourceOperation();Using an operation listener will provide information about requests and responses from the NMT device:
public class OperationListener implements TheDavidboxOperationListener{
@Override
public void onSendHttpRequest(String request) {
logger.debug(request);
}
@Override
public void onReceiveXmlResponse(String xmlResponse) {
logger.debug(xmlResponse);
}
}
//Use the constructor providing the listener
TheDavidBoxClient client = new TheDavidBoxClientImpl("IPorHostName",
clientOptions, new OperationListener());About the responses:
try {
ResponseGetPlaybackSpeedVod response = theDavidBoxClient.getModulePlayback().
buildGetPlaybackSpeedVodOperation().execute();
//Check first that response is valid
if (response.isValid()){
logger.info("Speed: " + response.getSpeed());
} else {
//if it is not valid you can see a description for the problem
logger.info("Problem description: " + response.getTypeReturnValue().
getDescription());
}
} catch (TheDavidBoxClientException e) {
//NMT device is switched off, problem parsing xml response, unreachable IP address, etc...
e.printStackTrace();
}To build locally you must use Java 1.5+ for compiling and apache maven 3.0.3+
mvn compile
To run tests:
mvn test
If you find any issues please report them or better, send a pull request.
- Rafael Iñigo (vikingBrain)
Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0
All product and company names are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them. All specifications are subject to change without notice. Popcorn Hour, Popbox, Networked Media Tank and SayaTv are trademarks of Syabas Technology Inc., Registered in the U.S.