sbIPlayQueueService.idl
Go to the documentation of this file.
1 /*
2  *=BEGIN SONGBIRD GPL
3  *
4  * This file is part of the Songbird web player.
5  *
6  * Copyright(c) 2005-2010 POTI, Inc.
7  * http://www.songbirdnest.com
8  *
9  * This file may be licensed under the terms of of the
10  * GNU General Public License Version 2 (the ``GPL'').
11  *
12  * Software distributed under the License is distributed
13  * on an ``AS IS'' basis, WITHOUT WARRANTY OF ANY KIND, either
14  * express or implied. See the GPL for the specific language
15  * governing rights and limitations.
16  *
17  * You should have received a copy of the GPL along with this
18  * program. If not, go to http://www.gnu.org/licenses/gpl.html
19  * or write to the Free Software Foundation, Inc.,
20  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21  *
22  *=END SONGBIRD GPL
23  */
24 
30 #include "nsISupports.idl"
31 
32 interface nsISimpleEnumerator;
33 interface sbIMediaItem;
34 interface sbIMediaList;
35 
42 [scriptable, uuid(abbeaac0-dc53-11df-937b-0800200c9a66)]
44 {
51  void onIndexUpdated(in unsigned long aToIndex);
52 
59 
66 };
67 
75 [scriptable, uuid(88849800-ddbe-11df-85ca-0800200c9a66)]
77 {
84  readonly attribute sbIMediaList mediaList;
85 
89  attribute unsigned long index;
90 
94  readonly attribute boolean operationInProgress;
95 
114  void queueNext(in sbIMediaItem aMediaItem);
115 
122  void queueLast(in sbIMediaItem aMediaItem);
123 
135  void queueSomeBefore(in unsigned long aIndex,
136  in nsISimpleEnumerator aMediaItems);
137 
152  void queueSomeNext(in nsISimpleEnumerator aMediaItems);
153 
164  void queueSomeLast(in nsISimpleEnumerator aMediaItems);
165 
181  void clearHistory();
182 
198  void clearAll();
199 
208  void addListener(in sbIPlayQueueServiceListener aListener);
209 
215  void removeListener(in sbIPlayQueueServiceListener aListener);
216 };
attribute unsigned long index
Index of the current track in the Play Queue.
void queueSomeBefore(in unsigned long aIndex, in nsISimpleEnumerator aMediaItems)
Adds an enumerator of media items before the slot specified by aIndex in the Play Queue asynchronousl...
void removeListener(in sbIPlayQueueServiceListener aListener)
Remove a listener for the service.
void queueSomeLast(in nsISimpleEnumerator aMediaItems)
Adds an enumerator of media items to the end of the Play Queue asynchronously. Items are not actually...
void clearHistory()
Clear the Play Queue's history.
void onQueueOperationCompleted()
fired when queue operation is completed.
readonly attribute sbIMediaList mediaList
The underlying MediaList for the Play Queue.
var uuid
A brief description of the contents of this interface.
void queueNext(in sbIMediaItem aMediaItem)
Adds a media item to the next slot in the Play Queue.
Listener for the Play Queue service.
readonly attribute boolean operationInProgress
Whether a queue operation is in progress.
void addListener(in sbIPlayQueueServiceListener aListener)
Add a listener for the service.
void clearAll()
Clear the Play Queue's contents.
void onQueueOperationStarted()
fired when queue operation is started.
Service for interacting with the Play Queue.
void queueLast(in sbIMediaItem aMediaItem)
Adds a media item to the end of the Play Queue.
void onIndexUpdated(in unsigned long aToIndex)
void queueSomeNext(in nsISimpleEnumerator aMediaItems)
Adds an enumerator of media items to the next slot in the Play Queue asynchronously. Items are not actually in the queue until the onQueueOperationCompleted notification is sent, and callers should not attempt to add or remove items from the queue while the operation is in progress.
Interface that defines a single item of media in the system.