Skip to main content
Version : 2.2.0

Haply::Inverse::Unity::DeviceBehaviour

Représente la classe de base pour les dispositifs Inverse, fournissant des fonctionnalités communes et une gestion des états.

Hérite de MonoBehaviour

Hérité de Haply.Inverse.Unity.Inverse3, Haply.Inverse.Unity.VerseGrip

Événements publics​

Nom
Action< DeviceBehaviour, Ret >Événement d'erreur()
ConnectionStateDelegateConnectionStateChanged()
Événement déclenché lorsque l'état de connexion de l'appareil change.
Action< DeviceBehaviour, DeviceConnectionState, DeviceConnectionState >ConnectionStateChangedAsync()
Événement déclenché peu après le changement d'état de la connexion de l'appareil.

Fonctions publiques​

Nom
délégué videConnectionStateDelegate(DeviceBehaviour device, DeviceConnectionState state, DeviceConnectionState prevState)
Délégué pour la gestion des changements d'état de connexion de l'appareil.
videSetSetupToPerform()
Indique que la configuration doit être effectuée dans la prochaine image.
override stringToString()
Renvoie une représentation sous forme de chaîne de caractères de l'objet, fournissant une description lisible par l'homme qui comprend le nom de l'objet, le type de classe et l'identifiant de l'appareil.

Fonctions protégées​

Nom
videInvokeReadyEvent()
Invoque l'événement Ready.
vide virtuelSetup()
Cette méthode est automatiquement appelée une fois que le drapeau _performSetup est activé pour gérer les calculs de consommation trop lourds pour être appelés à chaque image.
vide virtuelRéveil()
videOnEnable()
videOnDisable()
videOnDestroy()
vide virtuelMise à jour fixe()

Propriétés publiques​

Nom
DeviceTypeType d'appareil
Obtient le type de l'appareil.
intSelectedDeviceId
uintDeviceId
Obtient l'identifiant de l'appareil.
boolIsReady
Indique si l'appareil est prêt à être utilisé.
Comportement du curseurCurseur
Obtient ou définit le comportement du curseur associé à l'appareil.
DeviceConnectionStateÉtat de la connexion
Obtient ou définit l'état de connexion actuel de l'appareil.
boolEstConnecté
Indique si l'appareil est connecté.
boolIsOpened
Indique si l'appareil est ouvert.

Propriétés protégées​

Nom
BaseCoordinateConverterConvertisseur de coordonnées
boolIsCursorSet
Indique si le curseur a été défini.

Attributs publics​

Nom
const intANY_ID
UnityEvent< DeviceBehaviour >DeviceOpened
Événement déclenché lorsque l'état de connexion passe à l'état DeviceConnectionState.Opened.
UnityEvent< DeviceBehaviour >DeviceClosed
Événement déclenché lorsque l'état de connexion passe à l'état DeviceConnectionState.Connected.

Attributs protégés​

Nom
chaîne de caractèresNom de l'objet

Documentation sur les événements publics​

événement ErrorEvent​

Action< DeviceBehaviour, Ret > ErrorEvent()

événement ConnectionStateChanged​

ConnectionStateDelegate ConnectionStateChanged()

Événement déclenché lorsque l'état de connexion de l'appareil change.

événement ConnectionStateChangedAsync​

Action< DeviceBehaviour, DeviceConnectionState, DeviceConnectionState > ConnectionStateChangedAsync()

Événement déclenché peu après le changement d'état de la connexion de l'appareil.

Voir: ConnectionStateChanged

Cet événement est déclenché par le thread principal, ce qui permet des interactions sûres avec les objets de la scène Unity et les éléments de l'interface utilisateur. Notez que l'état de l'appareil est mis à jour sur un thread séparé à haute fréquence, de sorte que l'état au moment de l'événement peut différer légèrement de l'état actuel lors de la gestion de l'événement. Utilisez l'événement ConnectionStateChanged si vous avez besoin de plus de précision.

Documentation sur les fonctions publiques​

fonction ConnectionStateDelegate​

delegate void ConnectionStateDelegate(
DeviceBehaviour device,
DeviceConnectionState state,
DeviceConnectionState prevState
)

Délégué pour gérer les changements d'état de connexion de l'appareil.

Paramètres:

  • state Nouvel état de l'appareil.
  • prevState État précédent de l'appareil.
  • device L'instance de l'appareil à l'origine de l'événement.

fonction SetSetupToPerform​

void SetSetupToPerform()

Indique que la configuration doit être effectuée sur la trame suivante.

Voir: Configuration

fonction ToString​

override string ToString()

Renvoie une représentation sous forme de chaîne de caractères de l'objet, fournissant une description lisible par l'homme qui comprend le nom de l'objet, le type de classe et l'identifiant de l'appareil.

Retourner: Une chaîne de caractères représentant l'objet actuel, y compris son nom, son type de classe et l'identifiant de l'appareil.

The returned string follows the format: "name <Class>(#id)", where:

  • "nom" est la valeur du champ "nom" de l'objet. _objectName champ.
  • "Classe" est le nom du type de classe de l'objet.
  • "id" est l'ID de l'appareil, formaté comme une chaîne hexadécimale de 4 caractères, ou "*" si l'ID de l'appareil est ANY_ID. Si DeviceId est ANY_ID, la valeur de SelectedDeviceId est utilisé.

Cette méthode facilite le débogage et la journalisation en fournissant une description concise et informative de l'objet.

Documentation sur les fonctions protégées​

fonction InvokeReadyEvent​

void InvokeReadyEvent()

Invoque l'événement Ready.

Cette méthode est automatiquement appelée par la propriété IsReady lorsque sa valeur devient vraie. Elle doit être implémentée par les classes dérivées pour déclencher l'événement correspondant.

La propriété IsReady doit être fixée à true dans les classes dérivées lorsque l'appareil est entièrement initialisé et prêt à l'emploi.

fonction Setup​

virtual void Setup()

Cette méthode est automatiquement appelée une fois que l'indicateur _performSetup est activé pour gérer les calculs de consommation trop lourds pour être appelés à chaque image.

Réimplémenté par: Haply::Inverse::Unity::Inverse3::Setup

Cette méthode peut être remplacée en prenant soin de conserver l'appel de base. Utiliser SetSetupToPerform pour déclencher l'appel à Setup.

fonction Réveil​

virtual void Awake()

fonction OnEnable​

void OnEnable()

fonction OnDisable​

void OnDisable()

fonction OnDestroy​

void OnDestroy()

fonction FixedUpdate​

virtual void FixedUpdate()

Réimplémenté par: Haply::Inverse::Unity::Inverse3::FixedUpdate

Documentation sur les biens publics​

propriété DeviceType​

DeviceType DeviceType;

Obtient le type de l'appareil.

Peut être Inverse.DeviceTypeInverse3, Inverse.DeviceType.VerseGrip ou Inverse.DeviceType.Nil s'il n'est pas déjà défini par le DeviceMapper.

propriété SelectedDeviceId​

int SelectedDeviceId;

propriété DeviceId​

uint DeviceId;

Obtient l'identifiant de l'appareil.

propriété IsReady​

bool IsReady;

Indique si l'appareil est prêt à être utilisé.

propriété Cursor​

CursorBehaviour Cursor;

Obtient ou définit le comportement du curseur associé à l'appareil.

propriété ConnectionState​

DeviceConnectionState ConnectionState;

Obtient ou définit l'état actuel de la connexion de l'appareil.

L'appareil peut être dans l'état DeviceConnectionState.Disconnected, DeviceConnectionState.Connected ou DeviceConnectionState.Opened. Le changement d'état déclenche les événements correspondants et les notifications de changement d'état.

propriété IsConnected​

bool IsConnected;

Indique si l'appareil est connecté.

propriété IsOpened​

bool IsOpened;

Indique si le dispositif est ouvert.

Documentation sur les biens protégés​

propriété CoordinateConverter​

BaseCoordinateConverter CoordinateConverter;

propriété IsCursorSet​

bool IsCursorSet;

Indique si le curseur a été défini.

Cette propriété permet d'optimiser les vérifications de l'existence du curseur, car les comparaisons directes avec null peuvent être coûteuses dans Unity.

Documentation sur les attributs publics​

variable ANY_ID​

static const int ANY_ID = 0;

variable DeviceOpened​

UnityEvent< DeviceBehaviour > DeviceOpened;

Événement déclenché lorsque l'état de connexion passe à l'état DeviceConnectionState.Opened.

Voir: ConnectionStateChanged

Cela indique que l'appareil est prêt à être utilisé et que toutes les données nécessaires, telles que DeviceId et Inverse3.Handedness, ont été correctement initialisées. En fonction du DeviceType, l'instance DeviceBehaviour passée en premier argument peut être castée vers le type correspondant, soit Inverse3 ou VerseGrip.

Cet événement est déclenché par le thread principal, ce qui permet des interactions sûres avec les objets de la scène Unity et les éléments de l'interface utilisateur. Notez que l'état de l'appareil est mis à jour sur un thread séparé à haute fréquence, de sorte que l'état au moment de l'événement peut différer légèrement de l'état actuel lors de la gestion de l'événement. Utilisez l'événement ConnectionStateChanged si vous avez besoin de plus de précision.

variable DeviceClosed​

UnityEvent< DeviceBehaviour > DeviceClosed;

Événement déclenché lorsque l'état de connexion passe à l'état DeviceConnectionState.Connected.

Voir: ConnectionStateChanged

Cela indique que l'appareil n'est plus prêt à être utilisé. En fonction du type d'appareil, l'instance de DeviceBehaviour transmise en tant que premier argument peut être convertie dans le type correspondant, soit Inverse3 ou VerseGrip.

Cet événement est déclenché par le thread principal, ce qui permet des interactions sûres avec les objets de la scène Unity et les éléments de l'interface utilisateur. Notez que l'état de l'appareil est mis à jour sur un thread séparé à haute fréquence, de sorte que l'état au moment de l'événement peut différer légèrement de l'état actuel lors de la gestion de l'événement. Utilisez l'événement ConnectionStateChanged si vous avez besoin de plus de précision.

Documentation sur les attributs protégés​

variable _objectName​

string _objectName;