Sage TV API

[blackb0x]

Hi all,

I have a problem.
Is there any way that I can use the api of sage?
It seems that, after i imported all Sage.jar
All the classes is a.class b.class, ap.class etc...
There is no way that I can use the methods given in the Java Doc.

Thank you

[GKusnick]

There's extensive API documentation at http://download.sage.tv/api/index.html, including specific instructions on how to call the API from Studio and from Java.

However if you're talking about writing a standalone Java app that runs separately from SageTV.exe and uses Sage.jar as a class library, that's probably not going to work. The SageTV API is designed for use from within SageTV, either directly from Studio code or from Java classes called from Studio code.

Questions of this sort, relating to how to program SageTV addons and plugins, are probably best handled in the Studio forum.

[blackb0x]

Thank you...
I will go over to the other link u have stated to take a look...

[Mahoney]

blackb0x - the critical bit seems to be this:

The SageTV API calls can also be invoked from Java code directly. To do this, you can use the following static method in the sage.SageTV class:

public static Object api(String methodName, Object[] methodArgs) throws java.lang.reflect.InvocationTargetException;

The methodName parameter should be the name of the SageTV API call and the method Args should be an array of the arguments to pass to the API call. It is safe to use null for methodArgs if the call has no arguments. If an exception is thrown during execution of the SageTV API call then the exception will be wrapped in an InvocationTargetException and thrown.

As you've seen, they obfuscate their code prior to compilation, so you have to use this way of making the calls.

[jreichen]

Check out the source code for nielm's webserver on SourceForge (along with the sageutils project). It uses the
Sage API's extensively from Java. Your main class must implement Runnable (or inherit from Thread) and you need to add an entry to load_at_startup_runnable_classes= in the sage.properties file to tell Sage to load your class when it starts. Multiple entries are separated by a semicolon.

[GKusnick]

Originally Posted by jreichen

Your main class must implement Runnable (or inherit from Thread) and you need to add an entry to load_at_startup_runnable_classes= in the sage.properties file to tell Sage to load your class when it starts.

That's assuming you want to implement a background process that runs continuously and doesn't interact with the UI. Not every plugin needs to do that. If you just want to write some Java functions you can call from Studio widget code, you don't need to create a Runnable class or load it at startup.

If we had a better idea of what you're trying to accomplish, we could give better advice on how to accomplish it.

[Joshua]

Originally Posted by jreichen

Check out the source code for nielm's webserver on SourceForge (along with the sageutils project). It uses the
Sage API's extensively from Java. Your main class must implement Runnable (or inherit from Thread) and you need to add an entry to load_at_startup_runnable_classes= in the sage.properties file to tell Sage to load your class when it starts. Multiple entries are separated by a semicolon.

Originally Posted by GKusnick

That's assuming you want to implement a background process that runs continuously and doesn't interact with the UI. Not every plugin needs to do that. If you just want to write some Java functions you can call from Studio widget code, you don't need to create a Runnable class or load it at startup.

If we had a better idea of what you're trying to accomplish, we could give better advice on how to accomplish it.

Hi,

I am actually working together with Blackbox.

We had been using nielm's webserver and find it very useful. However, it lack of some functionalities that we hope to address. Examples :-

1. Enabling recording to the nearest minute.
2. Able to add daily, weekly recordings on the portal.
3. Able to name the recorded file with better meaning.

Our problem is getting started.

1. Can Sage Studio enable us to edit nielm's webserver ?
2. Where can we download or purchase Sage Studio ?

[Mahoney]

Sage Studio comes as part of Sage; you get into it by pressing some key (check the manual). Opus4 has links to the manual in his sig.

I imagine nielm's webserver is straight java code, so get it from CVS (see post above) and edit it in an IDE like Eclipse.

[jreichen]

Originally Posted by Mahoney

Sage Studio comes as part of Sage; you get into it by pressing some key (check the manual). Opus4 has links to the manual in his sig.

Ctrl+Shift+F12.

Originally Posted by Mahoney

I imagine nielm's webserver is straight java code, so get it from CVS (see post above) and edit it in an IDE like Eclipse.

Yes it is. An Eclipse project is checked into SF's CVS so you can do a new project in Eclipse and select 'Projects from CVS' and step through the wizard.