Reading Predictions

Though the python back end will provide a number responses, only predictions from the classifier are meaningful. Two levels of a stream reader class are provided. In most cases, the LSLResponseProvider should be the most helpful. Adding this component to a Unity scene will allow you to subscribe to response callbacks by type, dynamically opening and polling an inlet, providing parsed responses. Incoming responses will be provided to all subscribers but are not otherwise be saved. This means that any incoming responses not relevant to any active subscriber will be discarded upon reception.

using BCIEssentials.LSLFramework;

LSLResponseProvider InStream = GetComponent<LSLResponseProvider>();

void OnPredictionReceived(LSLPredictionResponse prediction)
{
    Debug.Log($"Prediction received for object #{prediction.Value}");
}

InStream.SubscribePredictions(OnPredictionReceived);
// or
InStream.Subscribe<LSLPredictionResponse>(OnPredictionReceived);
// or
InStream.SubscribePredictions(prediction => {
    Debug.Log($"Prediction received for object #{prediction.Value}");
}
// or
InStream.SubscribeAll(response => {
    if (response is LSLPredictionResponse prediction) {
        Debug.Log($"Prediction received for object #{prediction.Value}");
    }
}
// or
InStream.Subscribe<SingleChannelLSLResponse>(response => {
    if (response is LSLPredictionResponse prediction) {
        Debug.Log($"Prediction received for object #{prediction.Value}");
    }
}

// then
InStream.UsubscribePredictions(OnPredictionReceived);
// The unsubscribe method does not need to match the subscribe helper used.
// Invalidated callbacks (from destroyed components) will be automatically unsubscribed.
// This enabled the safe use of lambdas regardless of component lifetimes,
// but they cannot be unsubscribed manually unless a reference is stored somewhere.

The basic LSLStreamReader can also be used to manually pull typed responses if desired.

Response Types

Type	Description
`LSLResponse`	Base class for all responses, indicates parsing failure if not a more specific type
`EmptyLSLResponse`	LSL sample with no content
`SingleChannelLSLResponse`	Base class for all expected responses, indicates parsing failure if not a more specific type
`LSLPing`	“ping”
`LSLPredictionResponse`	Prediction from the classifier indicating the selection of a specific object
`LSLMarkerReceipt`	Confirmation of receipt for a marker