#import <SyphonServerDirectory.h>
Public Member Functions | |
| (NSArray *) | - serversMatchingName:appName: |
Static Public Member Functions | |
| (SyphonServerDirectory *) | + sharedDirectory |
Properties | |
| NSArray * | servers |
Server Description Dictionary Key Constants | |
| NSString *const | SyphonServerDescriptionUUIDKey |
| NSString *const | SyphonServerDescriptionNameKey |
| NSString *const | SyphonServerDescriptionAppNameKey |
| NSString *const | SyphonServerDescriptionIconKey |
Notifications | |
| NSString *const | SyphonServerAnnounceNotification |
| NSString *const | SyphonServerUpdateNotification |
| NSString *const | SyphonServerRetireNotification |
SyphonServerDirectory provides information on available Syphon Servers. Servers are represented by dictionaries. Generally you can expect to find some or all of the keys listed in Constants.
| + (SyphonServerDirectory *) sharedDirectory |
Returns the shared server directory instance. This object is KVO complaint, and can be used to observe changes in server availability, server names and statuses.
| - (NSArray *) serversMatchingName: | (NSString *) | name | |
| appName: | (NSString *) | appname | |
Use this method to discover servers based soley on their name, or application host name. Both parameters are optional. If you do not specify either, all available SyphonServers will be returned.
| name | Optional (pass nil to not specify) Name of the published SyphonServer, matches the key value for SyphonServerDescriptionNameKey |
| appname | Optional (pass nil to not specify) Application Name of the published SyphonServer, matches the key value for SyphonServerDescriptionAppNameKey |
- (NSString* const) SyphonServerDescriptionUUIDKey [related] |
The object for this key is a NSString which uniquely identifies a SyphonServer instance. If two dictionaries contain the same string for this key, they represent the same server. This is provided solely to allow you to programmatically determine the identity of a server, and should never be displayed to users in interface elements.
- (NSString* const) SyphonServerDescriptionNameKey [related] |
The object for this key is a NSString which is the human-readable non-unique name for the SyphonServer. If this string exists and is non-empty, you should use it in interface elements to identify the server, usually in combination with the name of the server's application (see SyphonServerDescriptionAppNameKey).
- (NSString* const) SyphonServerDescriptionAppNameKey [related] |
The object for this key is a NSString with the localized name of the application in which the SyphonServer is running. Use this in combination with the server's name (if present) to identify the server in interface elements.
- (NSString* const) SyphonServerDescriptionIconKey [related] |
The object for this key is a NSImage representation of the icon of the application in which the SyphonServer is running.
- (NSString* const) SyphonServerAnnounceNotification [related] |
A new SyphonServer is available on the system. The notification object is a NSDictionary describing the server.
- (NSString* const) SyphonServerUpdateNotification [related] |
An existing SyphonServer instance has changed its description. The notification object is a NSDictionary describing the server.
- (NSString* const) SyphonServerRetireNotification [related] |
A SyphonServer instance will no longer be available. The notification object is a NSDictionary describing the retiring server.
- (NSArray*) servers [read, assign] |
NSArray of NSDictionaries that describe (using the keys above) currently available SyphonServer instances on the system.
