Le SDK Android XR est désormais disponible en version Preview développeur. Votre avis nous intéresse. Pour nous contacter, consultez notre
page d'assistance.
Extension OpenXR XR_ANDROID_passthrough_camera_state
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Chaîne de nom
XR_ANDROID_passthrough_camera_state
Type d'extension
Extension d'instance
Numéro d'extension enregistré
461
Révision
1
Dépendances d'extension et de version
OpenXR 1.0
Date de dernière modification
2024-09-05
Contributeurs
Spencer Quin, Google
Jared Finder, Google
Kevin Moule, Google
Nihav Jain, Google
Présentation
Le démarrage de la caméra de passthrough peut prendre du temps et elle n'est pas toujours disponible immédiatement. Cette extension permet aux applications de connaître l'état actuel de la caméra de passthrough.
Obtenir l'état actuel de la caméra de passthrough
XrResult xrGetPassthroughCameraStateANDROID(
XrSession session,
const XrPassthroughCameraStateGetInfoANDROID* getInfo,
XrPassthroughCameraStateANDROID* cameraStateOutput);
Descriptions des paramètres
session
est un gestionnaire XrSession précédemment créé avec xrCreateSession.
getInfo
correspond à toute information qui affectera la détermination de l'état de la caméra.
cameraStateOutput
correspond à l'état actuel de la caméra.
xrGetPassthroughCameraStateANDROID récupère l'état actuel de la caméra de passthrough.
La structure XrPassthroughCameraStateGetInfoANDROID est une struct d'entrée/sortie qui spécifie les paramètres de la requête d'état de l'appareil photo.
typedef struct XrPassthroughCameraStateGetInfoANDROID {
XrStructureType type;
void* next;
} XrPassthroughCameraStateGetInfoANDROID;
Descriptions des membres
type
est le XrStructureType de cette structure.
next
est NULL
ou un pointeur vers la structure suivante d'une chaîne de structures.
L'énumération XrPassthroughCameraStateANDROID identifie les différents états dans lesquels la caméra de passthrough peut se trouver.
typedef enum XrPassthroughCameraStateANDROID {
XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID = 0,
XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID = 1,
XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID = 2,
XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID = 3,
XR_PASSTHROUGH_CAMERA_STATE_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrPassthroughCameraStateANDROID;
Les énumérations ont la signification suivante:
Enum |
Description |
XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID
|
L'appareil photo a été désactivé par une application, le système ou l'utilisateur. |
XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID
|
La caméra est en cours de mise en ligne et n'est pas encore prête à être utilisée. |
XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID
|
La caméra est prête à être utilisée. |
XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID
|
La caméra est dans un état d'erreur irrécupérable. |
Nouveaux types d'objets
Nouveaux types d'indicateurs
Nouvelles constantes d'énumération
L'énumération XrStructureType est étendue avec:
XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID
Nouvelles énumérations
Nouvelles structures
Nouvelles fonctions
Problèmes
Historique des versions
- Révision 1, 05/09/2024 (Spencer Quin)
- Version initiale.
OpenXR™ et le logo OpenXR sont des marques appartenant à The Khronos Group Inc. et sont enregistrés en tant que marques en Chine, dans l'Union européenne, au Japon et au Royaume-Uni.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# XR_ANDROID_passthrough_camera_state OpenXR extension\n\n**Name String**\n\n`XR_ANDROID_passthrough_camera_state`\n\n**Extension Type**\n\nInstance extension\n\n**Registered Extension Number**\n\n461\n\n**Revision**\n\n1\n\n**Extension and Version Dependencies**\n\n[OpenXR 1.0](https://registry.khronos.org/OpenXR/specs/1.0/html/xrspec.html#versions-1.0)\n\n**Last Modified Date**\n\n2024-09-05\n\n**Contributors**\n\nSpencer Quin, Google\n\nJared Finder, Google\n\nKevin Moule, Google\n\nNihav Jain, Google\n\nOverview\n--------\n\nThe passthrough camera can take time to start up and may not be immediately\navailable. This extension lets applications know the current state of the\npassthrough camera.\n\nGet the current passthrough camera state\n----------------------------------------\n\n XrResult xrGetPassthroughCameraStateANDROID(\n XrSession session,\n const XrPassthroughCameraStateGetInfoANDROID* getInfo,\n XrPassthroughCameraStateANDROID* cameraStateOutput);\n\n### Parameter Descriptions\n\n- `session` is an [XrSession](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#XrSession) handle previously created with [xrCreateSession](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#xrCreateSession).\n- `getInfo` is any info that will affect how camera state is determined.\n- `cameraStateOutput` is the current state of the camera.\n\n[xrGetPassthroughCameraStateANDROID](#xrGetPassthroughCameraStateANDROID) retrieves the current state of the\npassthrough camera.\n\nThe [XrPassthroughCameraStateGetInfoANDROID](#XrPassthroughCameraStateGetInfoANDROID) structure is an input/output\nstruct which specifies the camera state request\nparameters. \n\n typedef struct XrPassthroughCameraStateGetInfoANDROID {\n XrStructureType type;\n void* next;\n } XrPassthroughCameraStateGetInfoANDROID;\n\n### Member Descriptions\n\n- `type` is the [XrStructureType](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#XrStructureType) of this structure.\n- `next` is `NULL` or a pointer to the next structure in a structure chain.\n\nThe [XrPassthroughCameraStateANDROID](#XrPassthroughCameraStateANDROID) enumeration identifies different states\nwhich the passthrough camera can be in. \n\n typedef enum XrPassthroughCameraStateANDROID {\n XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID = 0,\n XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID = 1,\n XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID = 2,\n XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID = 3,\n XR_PASSTHROUGH_CAMERA_STATE_MAX_ENUM_ANDROID = 0x7FFFFFFF\n } XrPassthroughCameraStateANDROID;\n\nThe enums have the following meanings:\n\n| Enum | Description |\n|----------------------------------------------------|-----------------------------------------------------------------|\n| `XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID` | The camera has been disabled by an app, the system or the user. |\n| `XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID` | The camera is still coming online and not yet ready to use. |\n| `XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID` | The camera is ready to use. |\n| `XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID` | The camera is in an unrecoverable error state. |\n\n**New Object Types**\n\n**New Flag Types**\n\n**New Enum Constants**\n\n[XrStructureType](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#XrStructureType) enumeration is extended with:\n\n- `XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID`\n\n**New Enums**\n\n- [XrPassthroughCameraStateANDROID](#XrPassthroughCameraStateANDROID)\n\n**New Structures**\n\n- [XrPassthroughCameraStateGetInfoANDROID](#XrPassthroughCameraStateGetInfoANDROID)\n\n**New Functions**\n\n- [xrGetPassthroughCameraStateANDROID](#xrGetPassthroughCameraStateANDROID)\n\n**Issues**\n\n**Version History**\n\n- Revision 1, 2024-09-05 (Spencer Quin)\n- Initial version.\n\n*** ** * ** ***\n\nOpenXR™ and the OpenXR logo are trademarks owned\nby The Khronos Group Inc. and are registered as a trademark in China,\nthe European Union, Japan and the United Kingdom."]]