mirror of
https://github.com/openharmony/interface_sdk_c.git
synced 2026-08-24 14:32:50 -04:00
jinsitao
123 lines
4.4 KiB
C
123 lines
4.4 KiB
C
/*
|
|
* Copyright (c) 2025 Huawei Device Co., Ltd.
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @addtogroup GameController
|
|
* @{
|
|
*
|
|
* @brief Provides APIs for game controller capability.
|
|
*
|
|
* @since 21
|
|
*/
|
|
|
|
/**
|
|
* @file game_device.h
|
|
* @brief Defines game device capabilities APIs for game app.
|
|
* @kit GameControllerKit
|
|
* @library libohgame_controller.z.so
|
|
* @syscap SystemCapability.Game.GameController
|
|
* @since 21
|
|
*/
|
|
|
|
#ifndef GAME_DEVICE_H
|
|
#define GAME_DEVICE_H
|
|
|
|
#include <stdint.h>
|
|
#include "game_device_event.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Defines a struct for the calling result of {@link OH_GameDevice_GetAllDeviceInfos}.
|
|
* @since 21
|
|
*/
|
|
typedef struct GameDevice_AllDeviceInfos GameDevice_AllDeviceInfos;
|
|
|
|
/**
|
|
* @brief Obtains all online devices.
|
|
* @param allDeviceInfos Double pointer to the {@link GameDevice_AllDeviceInfos} instance.
|
|
* The value cannot be null. Otherwise, an error code is returned.
|
|
* @return Returns {@link GAME_CONTROLLER_SUCCESS} if the operation is successful.
|
|
* Returns {@link GAME_CONTROLLER_MULTIMODAL_INPUT_ERROR} if the multimodal input is abnormal.
|
|
* @since 21
|
|
*/
|
|
GameController_ErrorCode OH_GameDevice_GetAllDeviceInfos(GameDevice_AllDeviceInfos** allDeviceInfos);
|
|
|
|
/**
|
|
* @brief Registers a monitor for the game device.
|
|
* @param deviceMonitorCallback Callback function, which is {@link GameDevice_DeviceMonitorCallback}.
|
|
* The value cannot be null. Otherwise, an error code is returned.
|
|
* @return Returns {@link GAME_CONTROLLER_SUCCESS} if the operation is successful.
|
|
* Returns {@link GAME_CONTROLLER_PARAM_ERROR} if the value of deviceMonitorCallback is null.
|
|
* @since 21
|
|
*/
|
|
GameController_ErrorCode OH_GameDevice_RegisterDeviceMonitor(
|
|
GameDevice_DeviceMonitorCallback deviceMonitorCallback);
|
|
|
|
/**
|
|
* @brief Unregisters the monitor for the game device.
|
|
* @return Returns {@link GAME_CONTROLLER_SUCCESS} if the operation is successful.
|
|
* @since 21
|
|
*/
|
|
GameController_ErrorCode OH_GameDevice_UnregisterDeviceMonitor(void);
|
|
|
|
/**
|
|
* @brief Destroys an {@link GameDevice_AllDeviceInfos} instance when it is no longer used.
|
|
* @param allDeviceInfos Double pointer to the {@link GameDevice_AllDeviceInfos} instance.
|
|
* The value cannot be null. Otherwise, an error code is returned.
|
|
* @return Returns {@link GAME_CONTROLLER_SUCCESS} if the operation is successful.
|
|
* Returns {@link GAME_CONTROLLER_PARAM_ERROR} if the value of allDeviceInfos is null.
|
|
* @since 21
|
|
*/
|
|
GameController_ErrorCode OH_GameDevice_DestroyAllDeviceInfos(GameDevice_AllDeviceInfos** allDeviceInfos);
|
|
|
|
/**
|
|
* @brief Obtains the number of devices.
|
|
* @param allDeviceInfos Pointer to the {@link GameDevice_AllDeviceInfos} instance.
|
|
* The value cannot be null. Otherwise, an error code is returned.
|
|
* @param count Pointer to the number of devices.
|
|
* @return Returns {@link GAME_CONTROLLER_SUCCESS} if the operation is successful.
|
|
* Returns {@link GAME_CONTROLLER_PARAM_ERROR} if the value of allDeviceInfos is null.
|
|
* @since 21
|
|
*/
|
|
GameController_ErrorCode OH_GameDevice_AllDeviceInfos_GetCount(
|
|
const struct GameDevice_AllDeviceInfos* allDeviceInfos,
|
|
int32_t* count);
|
|
|
|
/**
|
|
* @brief Obtains information about a device with a specified index.
|
|
* @param allDeviceInfos Pointer to the {@link GameDevice_AllDeviceInfos} instance.
|
|
* The value cannot be null. Otherwise, an error code is returned.
|
|
* @param index Specified device index.
|
|
* @param deviceInfo Double pointer to the device information.
|
|
* @return Returns {@link GAME_CONTROLLER_SUCCESS} if the operation is successful.
|
|
* Returns {@link GAME_CONTROLLER_PARAM_ERROR} if the value of allDeviceInfos is null,
|
|
* or the value of index is less than 0 or greater than or equal to the total number of devices.
|
|
* @since 21
|
|
*/
|
|
GameController_ErrorCode OH_GameDevice_AllDeviceInfos_GetDeviceInfo(
|
|
const struct GameDevice_AllDeviceInfos* allDeviceInfos,
|
|
const int32_t index,
|
|
GameDevice_DeviceInfo** deviceInfo);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif //GAME_DEVICE_H
|
|
/** @} */
|