1 /*****************************************************************************
6 * Created by Martin Kahr on 11.03.06 under a MIT-style license.
7 * Copyright (c) 2006 martinkahr.com. All rights reserved.
9 * Permission is hereby granted, free of charge, to any person obtaining a
10 * copy of this software and associated documentation files (the "Software"),
11 * to deal in the Software without restriction, including without limitation
12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13 * and/or sell copies of the Software, and to permit persons to whom the
14 * Software is furnished to do so, subject to the following conditions:
16 * The above copyright notice and this permission notice shall be included
17 * in all copies or substantial portions of the Software.
19 * THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
27 *****************************************************************************
29 * Note that changes made by any members or contributors of the VideoLAN team
30 * (i.e. changes that were checked in exclusively into one of VideoLAN's source code
31 * repositories) are licensed under the GNU General Public License version 2,
32 * or (at your option) any later version.
33 * Thus, the following statements apply to our changes:
35 * Copyright (C) 2006-2007 the VideoLAN team
36 * Authors: Eric Petit <titer@m0k.org>
37 * Felix Kühne <fkuehne at videolan dot org>
39 * This program is free software; you can redistribute it and/or modify
40 * it under the terms of the GNU General Public License as published by
41 * the Free Software Foundation; either version 2 of the License, or
42 * (at your option) any later version.
44 * This program is distributed in the hope that it will be useful,
45 * but WITHOUT ANY WARRANTY; without even the implied warranty of
46 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
47 * GNU General Public License for more details.
49 * You should have received a copy of the GNU General Public License
50 * along with this program; if not, write to the Free Software
51 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
52 *****************************************************************************/
54 #import <Cocoa/Cocoa.h>
56 #import <mach/mach_error.h>
57 #import <IOKit/IOKitLib.h>
58 #import <IOKit/IOCFPlugIn.h>
59 #import <IOKit/hid/IOHIDLib.h>
60 #import <IOKit/hid/IOHIDKeys.h>
62 enum AppleRemoteEventIdentifier
64 kRemoteButtonVolume_Plus =1<<1,
65 kRemoteButtonVolume_Minus =1<<2,
66 kRemoteButtonMenu =1<<3,
67 kRemoteButtonPlay =1<<4,
68 kRemoteButtonRight =1<<5,
69 kRemoteButtonLeft =1<<6,
70 kRemoteButtonRight_Hold =1<<7,
71 kRemoteButtonLeft_Hold =1<<8,
72 kRemoteButtonMenu_Hold =1<<9,
73 kRemoteButtonPlay_Sleep =1<<10,
74 kRemoteControl_Switched =1<<11,
75 kRemoteButtonVolume_Plus_Hold =1<<12,
76 kRemoteButtonVolume_Minus_Hold =1<<13,
77 k2009RemoteButtonPlay =1<<14,
78 k2009RemoteButtonFullscreen =1<<15
80 typedef enum AppleRemoteEventIdentifier AppleRemoteEventIdentifier;
82 /* Encapsulates usage of the apple remote control
83 This class is implemented as a singleton as there is exactly one remote per machine (until now)
84 The class is not thread safe
86 @interface AppleRemote : NSObject {
87 IOHIDDeviceInterface** hidDeviceInterface;
88 IOHIDQueueInterface** queue;
89 NSMutableArray* allCookies;
90 NSMutableDictionary* cookieToButtonMapping;
91 CFRunLoopSourceRef eventSource;
93 BOOL openInExclusiveMode;
94 BOOL simulatePlusMinusHold;
95 BOOL processesBacklog;
97 /* state for simulating plus/minus hold */
98 BOOL lastEventSimulatedHold;
99 AppleRemoteEventIdentifier lastPlusMinusEvent;
100 NSTimeInterval lastPlusMinusEventTime;
103 unsigned int clickCountEnabledButtons;
104 NSTimeInterval maxClickTimeDifference;
105 NSTimeInterval lastClickCountEventTime;
106 AppleRemoteEventIdentifier lastClickCountEvent;
107 unsigned int eventClickCount;
109 IBOutlet id delegate;
114 - (BOOL) isRemoteAvailable;
116 - (BOOL) isListeningToRemote;
117 - (void) setListeningToRemote: (BOOL) value;
119 - (BOOL) isOpenInExclusiveMode;
120 - (void) setOpenInExclusiveMode: (BOOL) value;
122 /* click counting makes it possible to recognize if the user has pressed a button repeatedly
123 * click counting does delay each event as it has to wait if there is another event (second click)
124 * therefore there is a slight time difference (maximumClickCountTimeDifference) between a single click
125 * of the user and the call of your delegate method
126 * click counting can be enabled individually for specific buttons. Use the property clickCountEnableButtons
127 * to set the buttons for which click counting shall be enabled */
128 - (BOOL) clickCountingEnabled;
129 - (void) setClickCountingEnabled: (BOOL) value;
131 - (unsigned int) clickCountEnabledButtons;
132 - (void) setClickCountEnabledButtons: (unsigned int)value;
134 /* the maximum time difference till which clicks are recognized as multi clicks */
135 - (NSTimeInterval) maximumClickCountTimeDifference;
136 - (void) setMaximumClickCountTimeDifference: (NSTimeInterval) timeDiff;
138 /* When your application needs to much time on the main thread when processing an event other events
139 * may already be received which are put on a backlog. As soon as your main thread
140 * has some spare time this backlog is processed and may flood your delegate with calls.
141 * Backlog processing is turned off by default. */
142 - (BOOL) processesBacklog;
143 - (void) setProcessesBacklog: (BOOL) value;
145 /* Sets an NSApplication delegate which starts listening when application is becoming active
146 * and stops listening when application resigns being active.
147 * If an NSApplication delegate has been already set all method calls will be forwarded to this delegate, too. */
148 - (BOOL) listeningOnAppActivate;
149 - (void) setListeningOnAppActivate: (BOOL) value;
151 /* Simulating plus/minus hold does deactivate sending of individual requests for plus/minus pressed down/released.
152 * Instead special hold events are being triggered when the user is pressing and holding plus/minus for a small period.
153 * With simulating enabled the plus/minus buttons do behave as the left/right buttons */
154 - (BOOL) simulatesPlusMinusHold;
155 - (void) setSimulatesPlusMinusHold: (BOOL) value;
157 /* Delegates are not retained */
158 - (void) setDelegate: (id) delegate;
161 - (IBAction) startListening: (id) sender;
162 - (IBAction) stopListening: (id) sender;
165 @interface AppleRemote (Singleton)
167 + (AppleRemote*) sharedRemote;
171 /* Method definitions for the delegate of the AppleRemote class */
172 @interface NSObject(NSAppleRemoteDelegate)
174 - (void) appleRemoteButton: (AppleRemoteEventIdentifier)buttonIdentifier pressedDown: (BOOL) pressedDown clickCount: (unsigned int) count;
178 @interface AppleRemote (PrivateMethods)
179 - (void) setRemoteId: (int) aValue;
180 - (NSDictionary*) cookieToButtonMapping;
181 - (IOHIDQueueInterface**) queue;
182 - (IOHIDDeviceInterface**) hidDeviceInterface;
183 - (void) handleEventWithCookieString: (NSString*) cookieString sumOfValues: (SInt32) sumOfValues;
186 @interface AppleRemote (IOKitMethods)
187 - (io_object_t) findAppleRemoteDevice;
188 - (IOHIDDeviceInterface**) createInterfaceForDevice: (io_object_t) hidDevice;
189 - (BOOL) initializeCookies;
193 /* A NSApplication delegate which is used to activate and deactivate listening to the remote control
194 * dependent on the activation state of your application.
195 * All events are delegated to the original NSApplication delegate if necessary */
196 @interface AppleRemoteApplicationDelegate : NSObject {
197 id applicationDelegate;
200 - (id) initWithApplicationDelegate: (id) delegate;
201 - (id) applicationDelegate;