diff --git a/light/v1_0/ILightInterface.idl b/light/v1_0/ILightInterface.idl index ac97619e2806ef062bff042a1547ce9de86ac3f9..fb2f0eb9daefc41988e859ca630fc51a031e5395 100644 --- a/light/v1_0/ILightInterface.idl +++ b/light/v1_0/ILightInterface.idl @@ -20,7 +20,7 @@ * @brief Provides APIs for the light service. * * The light module provides a unified interface for the light service to access the light driver. - * After obtaining the driver object or proxy, the light service distinguishes light devices by type + * After obtaining the driver object or proxy, the light service distinguishes light devices by id * and call related APIs to obtain light information, turn on or off a light, or set the blinking mode. * @since 3.1 */ @@ -28,7 +28,7 @@ /** * @file ILightInterface.idl * - * @brief Declares common APIs of the light module. These APIs can be used to obtain the light type, + * @brief Declares common APIs of the light module. These APIs can be used to obtain the light id, * turn on or off a light, and set the light brightness and blinking mode. * @since 3.1 */ @@ -57,14 +57,14 @@ interface ILightInterface { GetLightInfo([out] struct HdfLightInfo[] info); /** - * @brief Turns on available lights in the list based on the specified light type. + * @brief Turns on available lights in the list based on the specified light id. * - * @param lightId Indicates the light type. For details, see {@link HdfLightType}. + * @param lightId Indicates the light id. For details, see {@link HdfLightId}. * * @param effect Indicates the pointer to the lighting effect. For details, see {@link HdfLightEffect}. * * @return Returns 0 if the operation is successful. - * @return Returns -1 if the light type is not supported. + * @return Returns -1 if the light id is not supported. * @return Returns -2 if the blinking setting is not supported. * @return Returns -3 if the brightness setting is not supported. * @@ -73,9 +73,9 @@ interface ILightInterface { TurnOnLight([in] int lightId, [in] struct HdfLightEffect effect); /** - * @brief Turns off available lights in the list based on the specified light type. + * @brief Turns off available lights in the list based on the specified light id. * - * @param lightId Indicates the light type. For details, see {@link HdfLightType}. + * @param lightId Indicates the light id. For details, see {@link HdfLightId}. * * @return Returns 0 if the operation is successful. * @return Returns a negative value if the operation fails. diff --git a/light/v1_0/LightTypes.idl b/light/v1_0/LightTypes.idl index bbe19da3e55f4e1a551458589a9f234a881df1a9..29b4db5f6e5089cdf4c1a9b1a22a9c38a4434d41 100644 --- a/light/v1_0/LightTypes.idl +++ b/light/v1_0/LightTypes.idl @@ -21,14 +21,14 @@ * * The light module provides a unified interface for the light service to access the light driver. * After obtaining the light driver object or proxy, the service can call related APIs to obtain light information, - * turn on or off a light, and set the light blinking mode based on the light type. + * turn on or off a light, and set the light blinking mode based on the light id. * @since 3.1 */ /** * @file LightTypes.idl * - * @brief Defines the light data structure, including the light type, lighting mode, + * @brief Defines the light data structure, including the light id, lighting mode, * blinking mode and duration, return values, and lighting effect. * @since 3.1 */ @@ -36,26 +36,26 @@ package ohos.hdi.light.v1_0; /** - * @brief Enumerates the light types. + * @brief Enumerates the light ids. * * @since 3.1 */ -enum HdfLighType { - HDF_LIGHT_TYPE_BATTERY = 1, - HDF_LIGHT_TYPE_NOTIFICATIONS = 2, - HDF_LIGHT_TYPE_ATTENTION = 3, +enum HdfLightId { + HDF_LIGHT_ID_BATTERY = 1, + HDF_LIGHT_ID_NOTIFICATIONS = 2, + HDF_LIGHT_ID_ATTENTION = 3, HDF_LIGHT_ID_BUTT = 4, }; /** * @brief Defines the basic light information. * - * Basic light information includes the light type and custom extended information. + * Basic light information includes the light id and custom extended information. * * @since 3.1 */ struct HdfLightInfo { - int lightId; /** Light type. For details, see {@link HdfLighType}. */ + int lightId; /** Light id. For details, see {@link HdfLightId}. */ int reserved; /** Custom extended information. */ };