|
|
| Line 1: |
Line 1: |
| − | '''VoiceServices plug-ins''' are plugins to the iOS voice dial feature. They provide possible results within plists and receive recognized results. | + | The NSAutoreleasePool class is a thin wrapper around the '''NSPushAutoreleasePool''' and '''NSPopAutoreleasePool''' functions. |
| | | | |
| − | There is currently no plugin loader available. Developers have to "hard-code" their plugins by writing them in [[/System/Library/VoiceServices/PlugIns]].
| + | <source lang="objc"> |
| − | | + | #ifdef __cplusplus |
| − | Currently, there is little known about the internals of VoiceServices plugins and their state of usability, especially on recent iOS versions.
| + | extern "C" { |
| − | | + | #endif |
| − | == iOS 6 ==
| + | void *NSPushAutoreleasePool(NSUInteger capacity); |
| − | In iOS 6 VoiceServices plugins can easily be loaded by creating an appropriate folder in [[/System/Library/VoiceServices/PlugIns]]. Plugins are slightly extended bundles and always have the suffix <tt>.vsplugin</tt>.
| + | void NSPopAutoreleasePool(void* token); |
| − | | + | #ifdef __cplusplus |
| − | === Info.plist ===
| + | } |
| − | The bundle contains an Info.plist and its typical elements, like <tt>CFBundleIdentifier</tt>.
| + | #endif |
| − | | + | </source> |
| − | Additional keys are:
| |
| − | | |
| − | <code>VSRecognitionVersion</code> which contains a string. Most probably an internal version identifier. The Base plugin currently has 4.0 as value.
| |
| − | | |
| − | <code>VSRecognitionModels</code> which contains an array of dictionaries.
| |
| − | | |
| − | ==== VSRecognitionModels ====
| |
| − | Every dictionary can contain the following keys:
| |
| − | | |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Key
| |
| − | ! Value type
| |
| − | ! Function
| |
| − | |-
| |
| − | | VSRecognitionModelIdentifier
| |
| − | | String
| |
| − | | Obligatory. Complete function unknown, seems to be some kind of internal identifier to sort all the different recognition handlers.
| |
| − | |-
| |
| − | | VSRecognitionModelFileName
| |
| − | | String
| |
| − | | Obligatory. The file name of all the possible recognition results. A localized suffix will be added by the plugin loader, for example if your name is "org.h6nry.test.plist" and you are french, it will search for a file named "org.h6nry.test-fr.plist".
| |
| − | |-
| |
| − | | VSRecognitionResultHandler
| |
| − | | String
| |
| − | | Obligatory. The name of the class which is implemented in the bundle executable and which should handle the results for all the recognition results provided in VSRecognitionModelFileName.
| |
| − | |}
| |
| | | | |
| − | === VSRecognitionModelFileName plist files ===
| + | Example: |
| − | These files are stored directly in the base directory of the bundle and are localized with "-lang-code" suffixes.
| |
| − | They have the following base structure:
| |
| − | <source lang=xml>
| |
| − | (xml and doctype plist references)
| |
| − | <dict>
| |
| − | <key>VSRecognitionClasses</key>
| |
| − | <array>
| |
| − | <dict>
| |
| − | <key>VSRecognitionClassIdentifier</key> <string>myClassIdentifier</string> <!-- Used for the VSRecognitionSequences array -->
| |
| − | <key>VSRecognitionClassElements</key> <!-- Array of words which are going to be recognized -->
| |
| − | <array>
| |
| − | <string>string 1</string>
| |
| − | <string>string 2</string>
| |
| − | <string>Hello</string>
| |
| − | <array>
| |
| − | </dict>
| |
| − | </array>
| |
| | | | |
| − | <key>VSRecognitionSequences</key> <!-- Specifies in which sequence all the just defined keywords are spoken -->
| + | <source lang="objc"> |
| − | <array>
| + | static void MyMethod() |
| − | <dict>
| + | { |
| − | <key>VSRecognitionSequenceElements</key>
| + | void *pool = NSPushAutoreleasePool(0); |
| − | <array>
| + | [[[NSObject alloc] init] autorelease]; |
| − | <string>myClassIdentifier</string>
| + | NSPopAutoreleasePool(pool); |
| − | <string>anotherClassIdentifier</string>
| + | } |
| − | </array>
| |
| − | </dict>
| |
| − | <dict>
| |
| − | <key>VSRecognitionSequenceElements</key>
| |
| − | <array>
| |
| − | <string>someOtherClassIdentifier</string>
| |
| − | <string>anotherClassIdentifier</string>
| |
| − | </array>
| |
| − | </dict>
| |
| − | </array> | |
| − | </dict>
| |
| | </source> | | </source> |
| − | This is just the very basic structure, there are other keys, objects and identifiers. Most of them can be obtained from the existing voice plugins, they are quite self-explanatory.
| |
| | | | |
| − | === The executable ===
| + | The "capacity" argument of NSPushAutoreleasePool only serves as a hint. It is unused in the current implementation. |
| − | The executable should implement all of the classes specified in the <tt>VSRecognitionResultHandler</tt> keys. These classes should conform to the VSRecognitionResultHandler protocol, which can be found in class-dumps of SpringBoard. It is being linked to the VoiceServices private framework.
| |
| | | | |
| − | == External links == | + | {{occlass|library=Foundation.framework}} |
| − |
| |
| − | * http://arstechnica.com/apple/2010/02/iphone-voiceservices-looking-under-the-hood/
| |
