Some Plugin API changes... Need to finish the API HeaderDocs sometime

[MenuTunes.git] / ITMTRemote.h

diff --git a/ITMTRemote.h b/ITMTRemote.h
index 735e11e..693d908 100755 (executable)
--- a/ITMTRemote.h
+++ b/ITMTRemote.h
@@ -28,7 +28,13 @@
 
 #import <Cocoa/Cocoa.h>
 
-typedef enum {stopped = -1, paused, playing, rewinding, forwarding} PlayerState;
+typedef enum {
+    stopped = -1,
+    paused,
+    playing,
+    rewinding,
+    forwarding
+} ITMTRemotePlayerState;
 
 /*! @protocol ITMTRemote
  *  @abstract Declares what a MenuTunes Remote must be able to do.
@@ -50,7 +56,7 @@ typedef enum {stopped = -1, paused, playing, rewinding, forwarding} PlayerState;
 + (id)remote;
 
 /*! @method title:
- *  @abstract Returns an autoreleased instance of the remote.
+ *  @abstract Returns the title of the plugin, which should be player name.
  *  @result An NSString containing the title.
  */
 - (NSString *)title;
@@ -79,7 +85,17 @@ typedef enum {stopped = -1, paused, playing, rewinding, forwarding} PlayerState;
  */
 - (BOOL)halt;
 
-- (PlayerState)playerState;
+/*! @method isAppRunning:
+ *  @abstract Returns controlled application's running status (is or isn't running).
+ *  @result BOOL of the controlled application's running status.
+ */
+- (BOOL)isAppRunning;
+
+/*! @method playerState:
+ *  @abstract Returns controlled application's playing state.
+ *  @result ITMTRemotePlayerState of the controlled application's playing state.
+ */
+- (ITMTRemotePlayerState)playerState;
 
 - (NSArray *)playlists;
 - (int)numberOfSongsInPlaylistAtIndex:(int)index;
@@ -96,9 +112,15 @@ typedef enum {stopped = -1, paused, playing, rewinding, forwarding} PlayerState;
 - (NSString *)currentSongLength;
 - (NSString *)currentSongRemaining;
 
+- (float)currentSongRating;
+- (BOOL)setCurrentSongRating:(float)rating;
+
 - (NSArray *)eqPresets;
 - (int)currentEQPresetIndex;
 
+- (float)volume;
+- (BOOL)setVolume:(float)volume;
+
 - (BOOL)play;
 - (BOOL)pause;
 - (BOOL)goToNextSong;