Microsoft Speech Platform

ISpObjectToken

The ISpObjectToken interface handles object token entries. A token is an object that represents a resource installed on a computer by the Microsoft Speech Platform, such as a Recognizer or a Voice.

A token provides an application a simple way to inspect the various attributes of a resource without having to instantiate it. The Language attribute of a recognizer, and the Gender attribute of a voice are examples of attributes of resources. Applications can find the best token that matches certain attributes by using the SpFindBestToken function. For more information and examples for developing with tokens, see Object Tokens and Categories Overview and Using Object Tokens and Categories.

Implemented By

SpObjectToken object. This is the standard class used for all existing object tokens in the Speech Platform. The data for each object token is stored in the registry.

How Created

• Applications will normally create object tokens from an object token enumerator or helper function, rather than by directly creating them.
• Various API methods also return an object token referring to a specific type of resource, for example, ISpRecognizer::GetRecognizer returns the object token associated with the current recognition engine, and ISpVoice::GetVoice returns the object token referring to the current TTS engine.

ISpObjectToken inherits from ISpDataKey.

Methods in Vtable Order

Remarks

Tokens are organized by category in the registry. See ISpObjectTokenCategory.