Rhino - Unity API

API Reference for the Rhino Unity SDK.

package: Pv.Unity

Inference

public class Inference

Class for storing data from a Rhino inference result.

Inference.`IsUnderstood`

public bool IsUnderstood { get; }

Indicates whether Rhino understood what it heard based on the context.

Inference.`Intent`

public string Intent { get; }

If IsUnderstood, name of intent that was inferred.

Inference.`Slots`

public Dictionary<string, string> Slots { get; }

If IsUnderstood, dictionary of slot keys and values that were inferred.

Rhino

public class Rhino : IDisposable

Class for the Rhino Speech-to-Intent engine.

Rhino.`ContextInfo`

public string ContextInfo { get; }

Gets the source of the Rhino context in YAML format. Shows the list of intents, which expressions map to those intents, as well as slots and their possible values.

Returns

string : Rhino context source.

Rhino.`FrameLength`

public int FrameLength { get; }

Gets the required number of audio samples-per-frame.

Returns

int : Required frame length.

Rhino.`SampleRate`

public int SampleRate { get; }

Get the audio sample rate required by Rhino.

Returns

int : Required sample rate in Hz.

Rhino.`Version`

public string Version { get; }

Gets the version number of the Rhino library.

Returns

string : Version of Rhino.

Rhino.`Create()`

public static Rhino Create(
        string accessKey,
        string contextPath,
        string modelPath = null,
        float sensitivity = 0.5f,
        bool requireEndpoint = true)

Factory method for creating instances of Rhino.

Parameters

accessKey string : AccessKey obtained from Picovoice Console.
contextPath string : Absolute path to the Rhino context file (.rhn).
modelPath string : Absolute path to the file containing model parameters (.pv). If not set, default model is used.
sensitivity float : Inference sensitivity. A higher sensitivity value results in fewer misses at the cost of (potentially) increasing the erroneous inference rate. Sensitivity should be a floating-point number within 0 and 1.
requireEndpoint requireEndpoint : If set to false, Rhino does not require an endpoint (chunk of silence) before finishing inference.

Returns

Rhino : An instance of the Rhino Speech-to-Intent engine.

Throws

RhinoException

Rhino.`Dispose()`

public void Dispose()

Explicitly releases resources acquired by Rhino.

Rhino.`GetInference()`

public Inference GetInference()

Gets inference results from Rhino. Should only be called after Process() returns true, otherwise Rhino has not yet reached an inference conclusion.

Returns

Inference : An object containing the results of a Rhino Inference.

Throws

RhinoException

Rhino.`Process()`

public bool Process(short[] pcm)

Processes a frame of audio and emits a flag indicating if the inference is ready. The number of samples-per-frame can be obtained by calling .FrameLength. The incoming audio needs to have a sample rate equal to .SampleRate and be 16-bit linearly-encoded. Rhino operates on single-channel audio.

Parameters

pcm short[] pcm : A frame of audio samples.

Returns

bool : Indicates whether Rhino has an inference ready or not.

Throws

RhinoException

RhinoException

public class RhinoException : Exception

Exception thrown if an error is encountered by the Rhino engine.

Exceptions:

public class RhinoActivationException           : RhinoException { }
public class RhinoActivationLimitException      : RhinoException { }
public class RhinoActivationRefusedException    : RhinoException { }
public class RhinoActivationThrottledException  : RhinoException { }
public class RhinoIOException                   : RhinoException { }
public class RhinoInvalidArgumentException      : RhinoException { }
public class RhinoInvalidStateException         : RhinoException { }
public class RhinoKeyException                  : RhinoException { }
public class RhinoMemoryException               : RhinoException { }
public class RhinoRuntimeException              : RhinoException { }
public class RhinoStopIterationException        : RhinoException { }

RhinoManager

public class RhinoManager

High-level API for the Rhino Speech-to-Intent engine. It handles audio recording and processing in real-time,
and notifies the client when an inference has been made.

RhinoManager.`IsAudioDeviceAvailable`

public bool IsAudioDeviceAvailable { get; }

Checks whether there are any audio capture devices available.

Returns

bool : If any available audio capture device are available.

RhinoManager.`IsRecording`

public bool IsRecording { get; }

Checks whether RhinoManager is capturing audio or not.

Returns

bool : If recording or not.

RhinoManager.`Create()`

public static RhinoManager Create(
        string accessKey,
        string contextPath,
        Action<Inference> inferenceCallback,
        string modelPath = null,
        float sensitivity = 0.5f,
        bool requireEndpoint = true,
        Action<RhinoException> processErrorCallback = null)

Factory method for creating instances of RhinoManager.

Parameters

accessKey string : AccessKey obtained from Picovoice Console.
inferenceCallback Action<Inference> : A callback that is invoked when Rhino has made an inference.
contextPath string : Absolute path to the Rhino context file (.rhn).
modelPath string : Absolute path to the file containing model parameters (.pv). If not set, default model is used.
sensitivity float : Inference sensitivity. A higher sensitivity value results in fewer misses at the cost of (potentially) increasing the erroneous inference rate. Sensitivity should be a floating-point number within 0 and 1.
requireEndpoint requireEndpoint : If set to false, Rhino does not require an endpoint (chunk of silence) before finishing inference.
processErrorCallback Action<RhinoException> : A callback that reports errors that are encountered while the engine is processing audio.

Returns

RhinoManager : An instance of the RhinoManager class.

Throws

RhinoException

RhinoManager.`Delete()`

public void Delete()

Free resources that were allocated to 'RhinoManager'.

RhinoManager.`Process()`

public void Process()

Starts audio capture and intent inference. Audio capture and processing is stopped automatically once Rhino has made an inference.

Throws

RhinoException