Music API?

[brturn]

What is the API to the music/sound library in GB-PVR? Do modules have access to the current playlist, etc?

I'm interested in writing a party-mode jukebox module, but don't want to re-write all the code that is already being used by the music module.

Thanks,
--Bryan

[sub]

The plugin API allows you specify a list of songs for playback, and also allows you force playback of a specific song. Normal GB-PVR functionality allows you to skip forward or back a track and pause/play/stop.

If you'd need specific APIs to be available other than these, just let me know what you need and I'll add them.

[brturn]

Sub,

Thanks for the response. Where is the list of APIs? I downloaded the WeatherPlugin and GB-PVR, but could not find the C++/C# API files. I have also looked through the documentation and the forums, but alas, no *.h files..?

I'm sure I'm missing the obvious doc or *.cs file..

Thanks,
--Bryan

[sub]

Support for plugins has only been in GB-PVR a few weeks, and I've not yet written any documentation to describe the API. The weather plugin gives a reasonable over of how you create a plugin. It only uses a couple of methods on the plugin helper, but here are the others:

<table border="0" align="center" width="95%" cellpadding="0" cellspacing="0"><tr><td>Code Sample </td></tr><tr><td id="CODE">using System.Xml;

namespace GBPVR.Public
{
/// <summary>
/// IPluginHelper exposes useful functions that can be used by the plugins.
/// To use call: PluginHelperFactory.getPluginHelper().ReturnToMainMenu()
/// </summary>
public interface IPluginHelper
{
void ReturnToMainMenu();

string GetSkinRootDirectory();

string GetInstallDirectory();

string getStandardSkinDirectory();

Image getSkinImage(string imageName, string skinSubDirectory);

XmlDocument GetConfiguration();

void PlayVideoFile(String filename);

void PlayAudioFile(String filename);

void PlayAudioFiles(Queue files);
}
}
[/QUOTE]

[sub]

http://gbpvr.com/cgi-bin/ikonboard.cgi?act=ST;f=4;t=1 contains a description of the interface that must be implemented by plugins.

[brturn]

Aha! That's what I was looking for.. Thanks. I'll poke around at the interface and see if I can get something working.

Some more quick questions;

- Why is there a 'string' and also a 'String', are these different classes?

- How does the music module display directories? Is that done 'by hand' in the code, or is there a File &amp; Directory selection module API?

Off hand, a jukebox will need these additional interfaces:

// Append a track to the currently playing queue
AppendAudioFile(..)

// Query information about the currently playing track
GetCurrentlyPlayingInfo( out string filename, out ... position, ..more..? )

As well as some event which is sent to the task when the queue has finished playing.

Thanks.
--Bryan

[sub]

I've added methods to:
pluginHelper.AddAudioFileToQueue(string filename)
IList playList = pluginHelper.GetAudioPlayQueue(out currentlyPlayingIndex)

I'll also think about an approach to supply the additional info you mentioned.

[Guest]

Sub,

It looks like there are two &quot;Bryans&quot; interested in additional audio related pluginHelper methods. It's probably too late to get anything else in release 17, but I thought I would at least mention a couple of new things.

1. Can you provide away to control the volume in the MVP. Either just up and down or set to a specific percentage level.

2. If a client was controlling a particular MVP and that MVP was put in &quot;Standby&quot;, could a task wake up the MVP out of &quot;Standby&quot;.

The other important one, that you already know about, is the ability to have the client return which MVP it is connected to.

Thanks,

Bryan B.

[sub]

The next release also contains a method to determine the client type (Overlay/VMR/XCARD/MVP). In the case of the MVP, the MAC address is appended to this.

I dont have the ability to place the MVP in standby or wake it up.

[Guest]

Good news on the MAC address.

Do you have away to change the volume?

Bryan