!868 add arkui docs in English

Merge pull request !868 from zengyawen/master

en/application-dev/Readme-EN.md

+# Application Development
+
+-   [Application Development Overview](application-dev-guide.md)
+-   [DevEco Studio \(OpenHarmony\) User Guide](quick-start/deveco-studio-user-guide-for-openharmony.md)
+
+-   [Directory Structure](quick-start/package-structure.md)
+-   [Getting Started](quick-start/start.md)
+
+-   [ArkUI](ui/ui-arkui.md)
+    -   [JavaScript-based Web-like Development Paradigm](ui/ui-arkui-js.md)
+
+    -   [TypeScript-based Declarative Development Paradigm](ui/ui-arkui-ts.md)
+
+-   [Audio](media/audio.md)
+
+-   [IPC & RPC](connectivity/ipc-rpc.md)
+
+-   [JavaScript Development References](js-reference/js-reference.md)
+    -   [JavaScript-based Web-like Development Paradigm](js-reference/js-based-web-like-development-paradigm/js-web-development-like.md)
+
+    -   [TypeScript-based Declarative Development Paradigm](js-reference/ts-based-declarative-development-paradigm/ts-declarative.md)

en/application-dev/application-dev-guide.md

-# App Development Overview<a name="EN-US_TOPIC_0000001123678714"></a>
+# Application Development Overview<a name="EN-US_TOPIC_0000001162242674"></a>
 
-This document provides guidance on how to develop apps through the JS APIs provided by OpenHarmony on the standard system.
+The application development documents provide reference for you to develop applications using the APIs provided by OpenHarmony. The documents provided walk you through how to use JavaScript \(JS\) APIs to develop applications on the standard system.
 
-To get a glimpse of the basic methods for developing apps, see  [Quick Start](quick-start/Readme-EN.md). For details about the API list and references, see  [JS Reference](js-reference/Readme-EN.md).
+To get a glimpse of the basic methods for developing applications, see  [Basics](quick-start/Readme-EN.md). For details about the API list and references, see  [JS Reference](js-reference/Readme-EN.md).
 
-To better understand frequently-used modules, see the development guidelines for  [UI](ui/Readme-EN.md),  [media](media/Readme-EN.md), and  [networks and connectivity](connectivity/Readme-EN.md).
+To better understand frequently used modules, see the development guidelines for  [UI](ui/Readme-EN.md),  [Media](media/Readme-EN.md), and  [Connectivity](connectivity/Readme-EN.md).
 
-For details about the principles and basic information of each subsystem, see the related README file in  **docs/en/readme**.
+For details about the principles and basic information of each subsystem, see the README file in  **docs/en/readme**.
 

en/application-dev/connectivity/Readme-EN.md

 # Connectivity
 
 -   [IPC & RPC](ipc-rpc.md)
-    -   [IPC & RPC Overview](ipc-rpc-overview.md)
-    -   [IPC & RPC Development Guidelines](ipc-rpc-development-guidelines.md)
-    -   [Subscribing to State Changes of a Remote Object](subscribing-to-state-changes-of-a-remote-object.md)
+    -   [IPC & RPC Overview](ipc-rpc-overview.md)  
+    -   [IPC & RPC Development Guidelines](ipc-rpc-development-guideline.md) 
+    
+    -   [Subscribing to State Changes of a Remote Object](subscribe-remote-state.md)  
 

en/application-dev/connectivity/ipc-rpc-development-guideline.md

+# IPC & RPC Development Guidelines<a name="EN-US_TOPIC_0000001103710988"></a>
+
+## When to Use<a name="section18502174174019"></a>
+
+IPC/RPC enables a proxy and a stub that run on different processes to communicate with each other, regardless of whether they run on the same or different devices.
+
+## Available APIs<a name="section1633115419401"></a>
+
+**Table  1**  Native IPC APIs
+
+<a name="table178849240013"></a>
+<table><thead align="left"><tr id="row6884924608"><th class="cellrowborder" valign="top" width="14.12141214121412%" id="mcps1.2.4.1.1"><p id="p98846241706"><a name="p98846241706"></a><a name="p98846241706"></a>Class/Interface</p>
+</th>
+<th class="cellrowborder" valign="top" width="52.54525452545254%" id="mcps1.2.4.1.2"><p id="p1488482414020"><a name="p1488482414020"></a><a name="p1488482414020"></a>Function</p>
+</th>
+<th class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.2.4.1.3"><p id="p388516244016"><a name="p388516244016"></a><a name="p388516244016"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="row15885824402"><td class="cellrowborder" valign="top" width="14.12141214121412%" headers="mcps1.2.4.1.1 "><p id="p08859241008"><a name="p08859241008"></a><a name="p08859241008"></a>IRemoteBroker</p>
+</td>
+<td class="cellrowborder" valign="top" width="52.54525452545254%" headers="mcps1.2.4.1.2 "><p id="p388572412010"><a name="p388572412010"></a><a name="p388572412010"></a>sptr&lt;IRemoteObject&gt; AsObject()</p>
+</td>
+<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p13885724405"><a name="p13885724405"></a><a name="p13885724405"></a>Obtains the holder of a remote proxy object. This method must be implemented by the derived classes of <strong id="b18927631105113"><a name="b18927631105113"></a><a name="b18927631105113"></a>IRemoteBroker</strong>. If you call this method on the stub, the <strong id="b7932163110519"><a name="b7932163110519"></a><a name="b7932163110519"></a>RemoteObject</strong> is returned; if you call this method on the proxy, the proxy object is returned.</p>
+</td>
+</tr>
+<tr id="row138859241808"><td class="cellrowborder" valign="top" width="14.12141214121412%" headers="mcps1.2.4.1.1 "><p id="p1888515245012"><a name="p1888515245012"></a><a name="p1888515245012"></a>IRemoteStub</p>
+</td>
+<td class="cellrowborder" valign="top" width="52.54525452545254%" headers="mcps1.2.4.1.2 "><p id="p1388516240011"><a name="p1388516240011"></a><a name="p1388516240011"></a>virtual int OnRemoteRequest(uint32_t code, MessageParcel &amp;data, MessageParcel &amp;reply, MessageOption &amp;option)</p>
+</td>
+<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p1188582414016"><a name="p1188582414016"></a><a name="p1188582414016"></a>Called to process a request from the proxy and return the result. Derived classes need to override this method.</p>
+</td>
+</tr>
+<tr id="row108856241904"><td class="cellrowborder" valign="top" width="14.12141214121412%" headers="mcps1.2.4.1.1 "><p id="p6885924609"><a name="p6885924609"></a><a name="p6885924609"></a>IRemoteProxy</p>
+</td>
+<td class="cellrowborder" valign="top" width="52.54525452545254%" headers="mcps1.2.4.1.2 ">&nbsp;&nbsp;</td>
+<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p688592413018"><a name="p688592413018"></a><a name="p688592413018"></a>Service proxy classes are derived from the <strong id="b169739356519"><a name="b169739356519"></a><a name="b169739356519"></a>IRemoteProxy</strong> class.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+## How to Develop<a name="section4207112818418"></a>
+
+**Using Native APIs**
+
+1.  Define the IPC interface  **ITestAbility**.
+
+    **ITestAbility**  inherits the IPC base class  **IRemoteBroker**  and defines descriptors, functions, and message code. The functions need to be implemented on both the proxy and stub.
+
+    ```
+    class ITestAbility : public IRemoteBroker {
+    public:
+    // DECLARE_INTERFACE_DESCRIPTOR is mandatory, and the input parameter is std::u16string.
+    DECLARE_INTERFACE_DESCRIPTOR(u"test.ITestAbility");
+    int TRANS_ID_PING_ABILITY = 1; // Define the message code.
+    virtual int TestPingAbility(const std::u16string &dummy) = 0; // Define functions.
+    };
+    ```
+
+2.  Define and implement service provider  **TestAbilityStub**.
+
+    This class is related to the IPC framework and needs to inherit  **IRemoteStub<ITestAbility\>**. You need to override  **OnRemoteRequest**  on the stub to receive requests from the proxy.
+
+    ```
+    class TestAbilityStub : public IRemoteStub<ITestAbility> {
+    public:
+        virtual int OnRemoteRequest(uint32_t code, MessageParcel &data, MessageParcel &reply, MessageOption &option) override;
+        int TestPingAbility(const std::u16string &dummy) override;
+    };
+     
+    int TestServiceStub::OnRemoteRequest(uint32_t code,
+        MessageParcel &data, MessageParcel &reply, MessageOption &option)
+    {
+        switch (code) {
+            case TRANS_ID_PING_ABILITY: {
+                std::u16string dummy = data.ReadString16();
+                int result = TestPingAbility(dummy);
+                reply.WriteInt32(result);
+                return 0;
+            }
+            default:
+                return IPCObjectStub::OnRemoteRequest(code, data, reply, option);
+        }
+    }
+    ```
+
+3.  Define the  **TestAbility**  class that implements functions for the stub.
+
+    ```
+    class TestAbility : public TestAbilityStub {
+    public:
+        int TestPingAbility(const std::u16string &dummy);
+    }
+    
+    int TestAbility::TestPingAbility(const std::u16string &dummy) {
+        return 0;
+    }
+    ```
+
+4.  Define and implement  **TestAbilityProxy**.
+
+    This class is implemented on the proxy and inherits  **IRemoteProxy<ITestAbility\>**. You can call  **SendRequest**  to send a request to the stub and expose the capabilities provided by the stub.
+
+    ```
+    class TestAbilityProxy : public IRemoteProxy<ITestAbility> {
+    public:
+        explicit TestAbilityProxy(const sptr<IRemoteObject> &impl);
+        int TestPingService(const std::u16string &dummy) override;
+    private:
+        static inline BrokerDelegator<TestAbilityProxy> delegator_; // Use the iface_cast macro.
+    }
+    
+    TestAbilityProxy::TestAbilityProxy(const sptr<IRemoteObject> &impl)
+        : IRemoteProxy<ITestAbility>(impl)
+    {
+    }
+    
+    int TestAbilityProxy::TestPingService(const std::u16string &dummy) {
+        MessageOption option;
+        MessageParcel dataParcel, replyParcel;
+        dataParcel.WriteString16(dummy);
+        int error = Remote()->SendRequest(TRANS_ID_PING_ABILITY, dataParcel, replyParcel, option);
+        int result = (error == ERR_NONE) ? replyParcel.ReadInt32() : -1;
+        return result;
+    }
+    ```
+
+5.  Register and start an SA.
+
+    Call  **AddSystemAbility**  to register the  **TestAbilityStub**  instance of the SA with  **SystemAbilityManager**. The registration parameters vary depending on whether the  **SystemAbilityManager**  resides on the same device as the SA.
+
+    ```
+    // Register the TestAbilityStub instance with the SystemAbilityManager on the same device as the SA.
+    auto samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
+    samgr->AddSystemAbility(said, new TestAbility());
+    
+    // Register the TestAbilityStub instance with the SystemAbilityManager on a different device.
+    auto samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
+    ISystemAbilityManager::SAExtraProp saExtra;
+    saExtra.isDistributed = true; // Set a distributed SA.
+    int result = samgr->AddSystemAbility(said, new TestAbility(), saExtra);
+    ```
+
+6.  Obtain the SA.
+
+    Call the  **GetSystemAbility**  function of the  **SystemAbilityManager**  class to obtain the  **IRemoteObject**  for the SA, and create a  **TestAbilityProxy**  instance.
+
+    ```
+    // Obtain the proxy of the SA registered on the local device.
+    sptr<ISystemAbilityManager> samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
+    sptr<IRemoteObject> remoteObject = samgr->GetSystemAbility(said);
+    sptr<ITestAbility> testAbility = iface_cast<ITestAbility>(remoteObject); // Use the iface_cast macro to convert the proxy to a specific type.
+    
+    // Obtain the proxies of the SAs registered with other devices.
+    sptr<ISystemAbilityManager> samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
+    sptr<IRemoteObject> remoteObject = samgr->GetSystemAbility(sdid, deviceId); // deviceId identifies a device.
+    sptr<TestAbilityProxy> proxy(new TestAbilityProxy(remoteObject)); // Construct a proxy.
+    ```
+
+

en/application-dev/connectivity/ipc-rpc-development-guidelines.md

-# IPC & RPC Development Guidelines<a name="EN-US_TOPIC_0000001103710988"></a>
-
--   [When to Use](#section18502174174019)
--   [Available APIs](#section1633115419401)
--   [How to Develop](#section4207112818418)
-
-## When to Use<a name="section18502174174019"></a>
-
-IPC/RPC enables a proxy and a stub that run on different processes to communicate with each other, regardless of whether they run on the same or different devices.
-
-## Available APIs<a name="section1633115419401"></a>
-
-**Table  1**  Native IPC APIs
-
-<a name="table178849240013"></a>
-<table><thead align="left"><tr id="row6884924608"><th class="cellrowborder" valign="top" width="14.12141214121412%" id="mcps1.2.4.1.1"><p id="p98846241706"><a name="p98846241706"></a><a name="p98846241706"></a>Class/Interface</p>
-</th>
-<th class="cellrowborder" valign="top" width="52.54525452545254%" id="mcps1.2.4.1.2"><p id="p1488482414020"><a name="p1488482414020"></a><a name="p1488482414020"></a>Function</p>
-</th>
-<th class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.2.4.1.3"><p id="p388516244016"><a name="p388516244016"></a><a name="p388516244016"></a>Description</p>
-</th>
-</tr>
-</thead>
-<tbody><tr id="row15885824402"><td class="cellrowborder" valign="top" width="14.12141214121412%" headers="mcps1.2.4.1.1 "><p id="p08859241008"><a name="p08859241008"></a><a name="p08859241008"></a>IRemoteBroker</p>
-</td>
-<td class="cellrowborder" valign="top" width="52.54525452545254%" headers="mcps1.2.4.1.2 "><p id="p388572412010"><a name="p388572412010"></a><a name="p388572412010"></a>sptr&lt;IRemoteObject&gt; AsObject()</p>
-</td>
-<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p13885724405"><a name="p13885724405"></a><a name="p13885724405"></a>Obtains the holder of a remote proxy object. This method must be implemented by the derived classes of <strong id="b18927631105113"><a name="b18927631105113"></a><a name="b18927631105113"></a>IRemoteBroker</strong>. If you call this method on the stub, the <strong id="b7932163110519"><a name="b7932163110519"></a><a name="b7932163110519"></a>RemoteObject</strong> is returned; if you call this method on the proxy, the proxy object is returned.</p>
-</td>
-</tr>
-<tr id="row138859241808"><td class="cellrowborder" valign="top" width="14.12141214121412%" headers="mcps1.2.4.1.1 "><p id="p1888515245012"><a name="p1888515245012"></a><a name="p1888515245012"></a>IRemoteStub</p>
-</td>
-<td class="cellrowborder" valign="top" width="52.54525452545254%" headers="mcps1.2.4.1.2 "><p id="p1388516240011"><a name="p1388516240011"></a><a name="p1388516240011"></a>virtual int OnRemoteRequest(uint32_t code, MessageParcel &amp;data, MessageParcel &amp;reply, MessageOption &amp;option)</p>
-</td>
-<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p1188582414016"><a name="p1188582414016"></a><a name="p1188582414016"></a>Called to process a request from the proxy and return the result. Derived classes need to override this method.</p>
-</td>
-</tr>
-<tr id="row108856241904"><td class="cellrowborder" valign="top" width="14.12141214121412%" headers="mcps1.2.4.1.1 "><p id="p6885924609"><a name="p6885924609"></a><a name="p6885924609"></a>IRemoteProxy</p>
-</td>
-<td class="cellrowborder" valign="top" width="52.54525452545254%" headers="mcps1.2.4.1.2 ">&nbsp;&nbsp;</td>
-<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p688592413018"><a name="p688592413018"></a><a name="p688592413018"></a>Service proxy classes are derived from the <strong id="b169739356519"><a name="b169739356519"></a><a name="b169739356519"></a>IRemoteProxy</strong> class.</p>
-</td>
-</tr>
-</tbody>
-</table>
-
-## How to Develop<a name="section4207112818418"></a>
-
-**Using Native APIs**
-
-1.  Define the IPC interface  **ITestAbility**.
-
-    **ITestAbility**  inherits the IPC base class  **IRemoteBroker**  and defines descriptors, functions, and message code. The functions need to be implemented on both the proxy and stub.
-
-    ```
-    class ITestAbility : public IRemoteBroker {
-    public:
-    // DECLARE_INTERFACE_DESCRIPTOR is mandatory, and the input parameter is std::u16string.
-    DECLARE_INTERFACE_DESCRIPTOR(u"test.ITestAbility");
-    int TRANS_ID_PING_ABILITY = 1; // Define the message code.
-    virtual int TestPingAbility(const std::u16string &dummy) = 0; // Define functions.
-    };
-    ```
-
-2.  Define and implement service provider  **TestAbilityStub**.
-
-    This class is related to the IPC framework and needs to inherit  **IRemoteStub<ITestAbility\>**. You need to override  **OnRemoteRequest**  on the stub to receive requests from the proxy.
-
-    ```
-    class TestAbilityStub : public IRemoteStub<ITestAbility> {
-    public:
-        virtual int OnRemoteRequest(uint32_t code, MessageParcel &data, MessageParcel &reply, MessageOption &option) override;
-        int TestPingAbility(const std::u16string &dummy) override;
-    };
-     
-    int TestServiceStub::OnRemoteRequest(uint32_t code,
-        MessageParcel &data, MessageParcel &reply, MessageOption &option)
-    {
-        switch (code) {
-            case TRANS_ID_PING_ABILITY: {
-                std::u16string dummy = data.ReadString16();
-                int result = TestPingAbility(dummy);
-                reply.WriteInt32(result);
-                return 0;
-            }
-            default:
-                return IPCObjectStub::OnRemoteRequest(code, data, reply, option);
-        }
-    }
-    ```
-
-3.  Define the  **TestAbility**  class that implements functions for the stub.
-
-    ```
-    class TestAbility : public TestAbilityStub {
-    public:
-        int TestPingAbility(const std::u16string &dummy);
-    }
-    
-    int TestAbility::TestPingAbility(const std::u16string &dummy) {
-        return 0;
-    }
-    ```
-
-4.  Define and implement  **TestAbilityProxy**.
-
-    This class is implemented on the proxy and inherits  **IRemoteProxy<ITestAbility\>**. You can call  **SendRequest**  to send a request to the stub and expose the capabilities provided by the stub.
-
-    ```
-    class TestAbilityProxy : public IRemoteProxy<ITestAbility> {
-    public:
-        explicit TestAbilityProxy(const sptr<IRemoteObject> &impl);
-        int TestPingService(const std::u16string &dummy) override;
-    private:
-        static inline BrokerDelegator<TestAbilityProxy> delegator_; // Use the iface_cast macro.
-    }
-    
-    TestAbilityProxy::TestAbilityProxy(const sptr<IRemoteObject> &impl)
-        : IRemoteProxy<ITestAbility>(impl)
-    {
-    }
-    
-    int TestAbilityProxy::TestPingService(const std::u16string &dummy) {
-        MessageOption option;
-        MessageParcel dataParcel, replyParcel;
-        dataParcel.WriteString16(dummy);
-        int error = Remote()->SendRequest(TRANS_ID_PING_ABILITY, dataParcel, replyParcel, option);
-        int result = (error == ERR_NONE) ? replyParcel.ReadInt32() : -1;
-        return result;
-    }
-    ```
-
-5.  Register and start an SA.
-
-    Call  **AddSystemAbility**  to register the  **TestAbilityStub**  instance of the SA with  **SystemAbilityManager**. The registration parameters vary depending on whether the  **SystemAbilityManager**  resides on the same device as the SA.
-
-    ```
-    // Register the TestAbilityStub instance with the SystemAbilityManager on the same device as the SA.
-    auto samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
-    samgr->AddSystemAbility(said, new TestAbility());
-    
-    // Register the TestAbilityStub instance with the SystemAbilityManager on a different device.
-    auto samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
-    ISystemAbilityManager::SAExtraProp saExtra;
-    saExtra.isDistributed = true; // Set a distributed SA.
-    int result = samgr->AddSystemAbility(said, new TestAbility(), saExtra);
-    ```
-
-6.  Obtain the SA.
-
-    Call the  **GetSystemAbility**  function of the  **SystemAbilityManager**  class to obtain the  **IRemoteObject**  for the SA, and create a  **TestAbilityProxy**  instance.
-
-    ```
-    // Obtain the proxy of the SA registered on the local device.
-    sptr<ISystemAbilityManager> samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
-    sptr<IRemoteObject> remoteObject = samgr->GetSystemAbility(said);
-    sptr<ITestAbility> testAbility = iface_cast<ITestAbility>(remoteObject); // Use the iface_cast macro to convert the proxy to a specific type.
-    
-    // Obtain the proxies of the SAs registered with other devices.
-    sptr<ISystemAbilityManager> samgr = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
-    sptr<IRemoteObject> remoteObject = samgr->GetSystemAbility(sdid, deviceId); // deviceId identifies a device.
-    sptr<TestAbilityProxy> proxy(new TestAbilityProxy(remoteObject)); // Construct a proxy.
-    ```
-
-

en/application-dev/connectivity/ipc-rpc-overview.md

 # IPC & RPC Overview<a name="EN-US_TOPIC_0000001103870800"></a>
 
--   [Basic Concepts](#section175012297491)
--   [Limitations and Constraints](#section2029921310472)
--   [Related Modules](#section1189019299446)
-
 ## Basic Concepts<a name="section175012297491"></a>
 
 The inter-process communication \(IPC\) and remote procedure call \(RPC\) mechanisms are used to implement cross-process communication. The difference between them lies in that IPC uses the Binder driver to implement cross-process communication within a device, whereas RPC uses the Intelligent Soft Bus driver to implement cross-process communication across devices. IPC and RPC generally use a client-server model. The service requester \(client\) can obtain the proxy of the service provider \(server\) and use the proxy to read and write data, thus implementing data communication between processes. Generally, the server registers system abilities \(SAs\) with the system ability manager \(SAMgr\), which manages the SAs and provides APIs for the client. To communicate with a specific SA, the client must obtain the proxy of the SA from SAMgr. In this document, Proxy represents the service requester, and Stub represents the service provider.

en/application-dev/connectivity/ipc-rpc.md

@@ -2,8 +2,8 @@
 
 -   **[IPC & RPC Overview](ipc-rpc-overview.md)**  
 
--   **[IPC & RPC Development Guidelines](ipc-rpc-development-guidelines.md)**  
+-   **[IPC & RPC Development Guidelines](ipc-rpc-development-guideline.md)**  
 
--   **[Subscribing to State Changes of a Remote Object](subscribing-to-state-changes-of-a-remote-object.md)**  
+-   **[Subscribing to State Changes of a Remote Object](subscribe-remote-state.md)**  
 
 

en/application-dev/js-reference/apis/audio-playback.md

+# Audio Playback<a name="EN-US_TOPIC_0000001103383404"></a>
+
+## Modules to Import<a name="s56d19203690d4782bfc74069abb6bd71"></a>
+
+```
+import audio from '@ohos.multimedia.media';
+```
+
+## Required Permissions<a name="section11257113618419"></a>
+
+None
+
+## Methods<a name="section125675489541"></a>
+
+## createAudioPlayer\(\)<a name="section582314017253"></a>
+
+Creates an  **AudioPlayer**  instance to control audio playback.
+
+**Return Values**
+
+<a name="table482411406254"></a>
+<table><thead align="left"><tr id="row138241940172518"><th class="cellrowborder" valign="top" width="16.05%" id="mcps1.1.3.1.1"><p id="p28256407257"><a name="p28256407257"></a><a name="p28256407257"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="83.95%" id="mcps1.1.3.1.2"><p id="p1582544017256"><a name="p1582544017256"></a><a name="p1582544017256"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="row0825540192520"><td class="cellrowborder" valign="top" width="16.05%" headers="mcps1.1.3.1.1 "><p id="p482574042511"><a name="p482574042511"></a><a name="p482574042511"></a><a href="#section5174142818365">AudioPlayer</a></p>
+</td>
+<td class="cellrowborder" valign="top" width="83.95%" headers="mcps1.1.3.1.2 "><p id="p14825194014258"><a name="p14825194014258"></a><a name="p14825194014258"></a>Returns the <strong id="b1322434113810"><a name="b1322434113810"></a><a name="b1322434113810"></a>AudioPlayer</strong> instance if the operation is successful; returns <strong id="b114701838153811"><a name="b114701838153811"></a><a name="b114701838153811"></a>null</strong> otherwise.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Example**
+
+```
+var audioplayer = audio.createAudioPlayer(); 
+```
+
+## Appendixes<a name="section1933416317165"></a>
+
+## AudioPlayer<a name="section5174142818365"></a>
+
+Represents an audio player.
+
+### Attributes<a name="section4947115405"></a>
+
+<a name="table92548495595"></a>
+<table><thead align="left"><tr id="row132541749175917"><th class="cellrowborder" valign="top" width="15.8015801580158%" id="mcps1.1.6.1.1"><p id="p925404965919"><a name="p925404965919"></a><a name="p925404965919"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="19.591959195919593%" id="mcps1.1.6.1.2"><p id="p325464914599"><a name="p325464914599"></a><a name="p325464914599"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="7.660766076607661%" id="mcps1.1.6.1.3"><p id="p025484918596"><a name="p025484918596"></a><a name="p025484918596"></a>Readable</p>
+</th>
+<th class="cellrowborder" valign="top" width="8.29082908290829%" id="mcps1.1.6.1.4"><p id="p025414499590"><a name="p025414499590"></a><a name="p025414499590"></a>Writable</p>
+</th>
+<th class="cellrowborder" valign="top" width="48.65486548654865%" id="mcps1.1.6.1.5"><p id="p20254134925912"><a name="p20254134925912"></a><a name="p20254134925912"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="row18254849155915"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="p20254204935915"><a name="p20254204935915"></a><a name="p20254204935915"></a>src</p>
+</td>
+<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="p1525413497591"><a name="p1525413497591"></a><a name="p1525413497591"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="p8254749195914"><a name="p8254749195914"></a><a name="p8254749195914"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="p5255549115910"><a name="p5255549115910"></a><a name="p5255549115910"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="p72551449145914"><a name="p72551449145914"></a><a name="p72551449145914"></a>URI of the audio resources</p>
+</td>
+</tr>
+<tr id="row10255134945917"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="p82551349125910"><a name="p82551349125910"></a><a name="p82551349125910"></a>loop</p>
+</td>
+<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="p18255154913598"><a name="p18255154913598"></a><a name="p18255154913598"></a>boolean</p>
+</td>
+<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="p525516497595"><a name="p525516497595"></a><a name="p525516497595"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="p2025504917593"><a name="p2025504917593"></a><a name="p2025504917593"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="p7255194925919"><a name="p7255194925919"></a><a name="p7255194925919"></a>Whether to loop audio playback</p>
+</td>
+</tr>
+<tr id="row18256049165911"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="p2256154919590"><a name="p2256154919590"></a><a name="p2256154919590"></a>currentTime</p>
+</td>
+<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="p10256849165915"><a name="p10256849165915"></a><a name="p10256849165915"></a>number</p>
+</td>
+<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="p19256149155915"><a name="p19256149155915"></a><a name="p19256149155915"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="p3256174935919"><a name="p3256174935919"></a><a name="p3256174935919"></a>No</p>
+</td>
+<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="p12256144995913"><a name="p12256144995913"></a><a name="p12256144995913"></a>Current playback position</p>
+</td>
+</tr>
+<tr id="row11256144911598"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="p92561949125910"><a name="p92561949125910"></a><a name="p92561949125910"></a>duration</p>
+</td>
+<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="p9256124914597"><a name="p9256124914597"></a><a name="p9256124914597"></a>number</p>
+</td>
+<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="p1725654915911"><a name="p1725654915911"></a><a name="p1725654915911"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="p192562049125910"><a name="p192562049125910"></a><a name="p192562049125910"></a>No</p>
+</td>
+<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="p125684995913"><a name="p125684995913"></a><a name="p125684995913"></a>Playback duration</p>
+</td>
+</tr>
+<tr id="row6256149115920"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="p2256144918596"><a name="p2256144918596"></a><a name="p2256144918596"></a>state</p>
+</td>
+<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="p9256144918593"><a name="p9256144918593"></a><a name="p9256144918593"></a><a href="#section5181155710523">AudioState</a></p>
+</td>
+<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="p102563495592"><a name="p102563495592"></a><a name="p102563495592"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="p625620497594"><a name="p625620497594"></a><a name="p625620497594"></a>No</p>
+</td>
+<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="p162571549195920"><a name="p162571549195920"></a><a name="p162571549195920"></a>Playback status</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+### play\(\)<a name="section964512672913"></a>
+
+Starts audio playback.
+
+**Example**
+
+```
+audioplayer.on('dataload', (err, action) => {
+  if (err) {
+     console.info('Error returned in the prepare() callback.');
+     return;
+  }
+  console.info('Start to play the audio.');
+  audioplayer.play();
+};
+
+audioplayer.on('play', (err, action) => {
+  if (err) {
+     console.info('Error returned in the play() callback.');
+     return;
+  }
+  console.info('Succeeded in playing the audio.');
+};
+audioplayer.src = 'common/mydream.mp3';
+```
+
+### pause\(\)<a name="section78173258296"></a>
+
+Pauses audio playback.
+
+**Example**
+
+```
+audioplayer.on('dataload', (err, action) => {
+  if (err) {
+     console.info('Error returned in the prepare() callback.');
+     return;
+  }
+  console.info('Start to play the audio.');
+  audioplayer.play();
+}
+audioplayer.on('play', (err, action) => {
+  if (err) {
+     console.info('Error returned in the play() callback.');
+     return;
+  }
+  console.info('Start to pause audio playback.');
+  audioplayer.pause();
+};
+audioplayer.on('pause', (err, action) => {
+  if (err) {
+     console.info('Error returned in the pause() callback.');
+     return;
+  }
+  console.info('Succeeded in pausing audio playback.');
+};
+audioplayer.src = 'common/mydream.mp3';
+```
+
+### stop\(\)<a name="section122114334296"></a>
+
+Stops audio playback.
+
+**Example**
+
+```
+audioplayer.on('dataload', (err, action) => {
+  if (err) {
+     console.info('Error returned in the prepare() callback.');
+     return;
+  }
+  console.info('Start to play the audio.');
+  audioplayer.play();
+};
+audioplayer.on('play', (err, action) => {
+  if (err) {
+     console.info('Error returned in the play() callback.');
+     return;
+  }
+  console.info('Start to pause audio playback.');
+  audioplayer.pause();
+};
+audioplayer.on('stop', (err, action) => {
+  if (err) {
+     console.info('Error returned in the stop() callback.');
+     return;
+  }
+  console.info('Succeeded in stopping audio playback.');
+};
+audioplayer.src = 'common/mydream.mp3';
+```
+
+### seek\(number\)<a name="section1387113816298"></a>
+
+Goes to a specified playback position.
+
+**Parameters**
+
+<a name="table1442723852917"></a>
+<table><thead align="left"><tr id="row84261138172911"><th class="cellrowborder" valign="top" width="17.57%" id="mcps1.1.5.1.1"><p id="p204261938182919"><a name="p204261938182919"></a><a name="p204261938182919"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="12.02%" id="mcps1.1.5.1.2"><p id="p1342683842920"><a name="p1342683842920"></a><a name="p1342683842920"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.5.1.3"><p id="p134260383297"><a name="p134260383297"></a><a name="p134260383297"></a>Mandatory</p>
+</th>
+<th class="cellrowborder" valign="top" width="62.89%" id="mcps1.1.5.1.4"><p id="p442663832912"><a name="p442663832912"></a><a name="p442663832912"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="row18427738202910"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.1.5.1.1 "><p id="p184261338192913"><a name="p184261338192913"></a><a name="p184261338192913"></a>timeMs</p>
+</td>
+<td class="cellrowborder" valign="top" width="12.02%" headers="mcps1.1.5.1.2 "><p id="p1242643819295"><a name="p1242643819295"></a><a name="p1242643819295"></a>number</p>
+</td>
+<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.5.1.3 "><p id="p44261838112918"><a name="p44261838112918"></a><a name="p44261838112918"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="62.89%" headers="mcps1.1.5.1.4 "><p id="p16427163812913"><a name="p16427163812913"></a><a name="p16427163812913"></a>Target playback position</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Example**
+
+```
+audioplayer.on('dataload', (err, action) => {
+  if (err) {
+     console.info('Error returned in the prepare() callback.');
+     return;
+  }
+  console.info('Start to play the audio.');
+  audioplayer.play();
+};
+audioplayer.on('play', (err, action) => {
+  if (err) {
+     console.info('Error returned in the play() callback.');
+     return;
+  }
+  console.info('Succeeded in playing the audio.')
+};
+audioplayer.on('timeUpdate', (seekTime, action) => {
+  console.info('Seek time returned in the seek() callback: ' + seekTime);
+  var newTime = audioplayer.currenTime;
+  if(newTime == 30000) {
+    console.info('Seek succeeded. New time: ' + newTime);
+  } else {
+    console.info('Seek failed.');
+  }
+};
+audioplayer.src = 'common/mydream.mp3';
+audioplayer.seek(30000);
+```
+
+### setVolume\(number\)<a name="section164235176552"></a>
+
+Sets the volume.
+
+**Parameters**
+
+<a name="table1242391713555"></a>
+<table><thead align="left"><tr id="row14424217195517"><th class="cellrowborder" valign="top" width="17.57%" id="mcps1.1.5.1.1"><p id="p1424917135519"><a name="p1424917135519"></a><a name="p1424917135519"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="12.02%" id="mcps1.1.5.1.2"><p id="p10424121795520"><a name="p10424121795520"></a><a name="p10424121795520"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.5.1.3"><p id="p1042415178559"><a name="p1042415178559"></a><a name="p1042415178559"></a>Mandatory</p>
+</th>
+<th class="cellrowborder" valign="top" width="62.89%" id="mcps1.1.5.1.4"><p id="p13424717125513"><a name="p13424717125513"></a><a name="p13424717125513"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="row13424171745513"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.1.5.1.1 "><p id="p204241517125517"><a name="p204241517125517"></a><a name="p204241517125517"></a>vol</p>
+</td>
+<td class="cellrowborder" valign="top" width="12.02%" headers="mcps1.1.5.1.2 "><p id="p18424121755517"><a name="p18424121755517"></a><a name="p18424121755517"></a>number</p>
+</td>
+<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.5.1.3 "><p id="p2042417176554"><a name="p2042417176554"></a><a name="p2042417176554"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="62.89%" headers="mcps1.1.5.1.4 "><p id="p9424171717557"><a name="p9424171717557"></a><a name="p9424171717557"></a>Volume to set. The value ranges from 0 to 1.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Example**
+
+```
+audioplayer.on('dataload', (err, action) => {
+  if (err) {
+     console.error('Error returned in the prepare() callback.');
+     return;
+  }
+  console.info('Start to play the audio.');
+  audioplayer.play();
+};
+audioplayer.on('play', (err, action) => {
+  if (err) {
+     console.error('Error returned in the play() callback.');
+     return;
+  }
+  console.info('Succeeded in playing the audio.')
+};
+audioplayer.on('volumeChange', (err, action) => {
+  if (err) {
+     console.error('Error returned in the setVolume() callback.');
+     return;
+  }
+  console.info('Playback volume changed.');
+};
+audioplayer.src = 'common/mydream.mp3';
+audioplayer.setVolume(0.5);
+```
+
+### reset\(\)<sup>7+</sup><a name="section1473283011356"></a>
+
+Switches the audio resource to be played.
+
+**Example**
+
+```
+audioplayer.on('dataload', (err, action) => {
+  if (err) {
+     console.error('Error returned in the prepare() callback.');
+     return;
+  }
+  console.info('Start to reset audio playback.');
+  audioplayer.reset();
+};
+audioplayer.on('reset', (err, action) => {
+  if (err) {
+     console.error('Error returned in the reset() callback.');
+     return;
+  }
+  console.info('Reset succeeded.');
+};
+audioplayer.src = 'common/mydream.mp3';
+```
+
+### release\(\)<a name="section9224621145512"></a>
+
+Releases audio resources.
+
+**Example**
+
+```
+audioplay.release();
+```
+
+### Events<a name="section5453721192911"></a>
+
+### play<a name="section87307411494"></a>
+
+Triggered when  **play\(\)**  is called
+
+### pause<a name="section198217471590"></a>
+
+Triggered when  **pause\(\)**  is called
+
+### stop<a name="section437616531910"></a>
+
+Triggered when  **stop\(\)**  is called
+
+### dataLoad<a name="section982114219106"></a>
+
+Triggered when audio data is loaded
+
+### timeUpdate<a name="section13687114181014"></a>
+
+Triggered when the playback position changes
+
+### volumeChange<a name="section139227715717"></a>
+
+Triggered when playback volume changes
+
+### finish<a name="section15181321181018"></a>
+
+Triggered when playback is finished
+
+### error<a name="section5593132921016"></a>
+
+Triggered when a playback error occurs
+
+<a name="table24591722143619"></a>
+<table><thead align="left"><tr id="row1945962219364"><th class="cellrowborder" valign="top" width="24.060000000000002%" id="mcps1.1.4.1.1"><p id="p84591522103610"><a name="p84591522103610"></a><a name="p84591522103610"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="25.25%" id="mcps1.1.4.1.2"><p id="p11459102243616"><a name="p11459102243616"></a><a name="p11459102243616"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="50.690000000000005%" id="mcps1.1.4.1.3"><p id="p14591922113616"><a name="p14591922113616"></a><a name="p14591922113616"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="row2459622183611"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.1.4.1.1 "><p id="p17338122234119"><a name="p17338122234119"></a><a name="p17338122234119"></a>callback</p>
+</td>
+<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.1.4.1.2 "><p id="p174601822193612"><a name="p174601822193612"></a><a name="p174601822193612"></a>ErrorCallback</p>
+</td>
+<td class="cellrowborder" valign="top" width="50.690000000000005%" headers="mcps1.1.4.1.3 "><p id="p7460222123612"><a name="p7460222123612"></a><a name="p7460222123612"></a>Callback function for handling this event</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+## AudioState<a name="section5181155710523"></a>
+
+Describes playback status.
+
+<a name="table919114616314"></a>
+<table><thead align="left"><tr id="row31917610318"><th class="cellrowborder" valign="top" width="33.739999999999995%" id="mcps1.1.3.1.1"><p id="p219196531"><a name="p219196531"></a><a name="p219196531"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="66.25999999999999%" id="mcps1.1.3.1.2"><p id="p14191563313"><a name="p14191563313"></a><a name="p14191563313"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="row3427194315719"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="p642711431172"><a name="p642711431172"></a><a name="p642711431172"></a>idle</p>
+</td>
+<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="p24281543777"><a name="p24281543777"></a><a name="p24281543777"></a>Audio playback is idle.</p>
+</td>
+</tr>
+<tr id="row2019146539"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="p201913617311"><a name="p201913617311"></a><a name="p201913617311"></a>playing</p>
+</td>
+<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="p81911362316"><a name="p81911362316"></a><a name="p81911362316"></a>The audio is being played.</p>
+</td>
+</tr>
+<tr id="row11912612316"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="p9191136731"><a name="p9191136731"></a><a name="p9191136731"></a>paused</p>
+</td>
+<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="p419166738"><a name="p419166738"></a><a name="p419166738"></a>Audio playback is paused.</p>
+</td>
+</tr>
+<tr id="row111912617314"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="p9191156333"><a name="p9191156333"></a><a name="p9191156333"></a>stopped</p>
+</td>
+<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="p2019215618316"><a name="p2019215618316"></a><a name="p2019215618316"></a>Audio playback is stopped.</p>
+</td>
+</tr>
+</tbody>
+</table>
+

en/application-dev/js-reference/apis/console-logs.md

+# Console Logs<a name="EN-US_TOPIC_0000001115814846"></a>
+
+## Module to Import<a name="en-us_topic_0000001058460515_s56d19203690d4782bfc74069abb6bd71"></a>
+
+No module is required.
+
+## Permission List<a name="en-us_topic_0000001058460515_section11257113618419"></a>
+
+None
+
+## Log Category<a name="en-us_topic_0000001058460515_s298a3cf59a3b470dbb0742706102ced7"></a>
+
+Prints a log using  **console.debug|log|info|warn|error\(message\)**.
+
+-   Parameter
+
+    <a name="en-us_topic_0000001058460515_t87748b0ba4e648079d53f9deccf4bfb2"></a>
+    <table><thead align="left"><tr id="en-us_topic_0000001058460515_rc5033ad045c14c2e806d59041aab002c"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="en-us_topic_0000001058460515_acf783ab6043e4ee1a7bb73b73a091e0b"><a name="en-us_topic_0000001058460515_acf783ab6043e4ee1a7bb73b73a091e0b"></a><a name="en-us_topic_0000001058460515_acf783ab6043e4ee1a7bb73b73a091e0b"></a>Name</p>
+    </th>
+    <th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="en-us_topic_0000001058460515_a6736505551534b819d5a6376065a25f6"><a name="en-us_topic_0000001058460515_a6736505551534b819d5a6376065a25f6"></a><a name="en-us_topic_0000001058460515_a6736505551534b819d5a6376065a25f6"></a>Type</p>
+    </th>
+    <th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="en-us_topic_0000001058460515_ac15c2a3de0e046af917cf09b48b3b46d"><a name="en-us_topic_0000001058460515_ac15c2a3de0e046af917cf09b48b3b46d"></a><a name="en-us_topic_0000001058460515_ac15c2a3de0e046af917cf09b48b3b46d"></a>Mandatory</p>
+    </th>
+    <th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="en-us_topic_0000001058460515_aeb94b88e78974288bab1b4940b50c840"><a name="en-us_topic_0000001058460515_aeb94b88e78974288bab1b4940b50c840"></a><a name="en-us_topic_0000001058460515_aeb94b88e78974288bab1b4940b50c840"></a>Description</p>
+    </th>
+    </tr>
+    </thead>
+    <tbody><tr id="en-us_topic_0000001058460515_r95c56d5cd62d4b518c3e7a3f158ed7fe"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="en-us_topic_0000001058460515_a7af41aec9a404f418202d90c61774825"><a name="en-us_topic_0000001058460515_a7af41aec9a404f418202d90c61774825"></a><a name="en-us_topic_0000001058460515_a7af41aec9a404f418202d90c61774825"></a>message</p>
+    </td>
+    <td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="en-us_topic_0000001058460515_aed6ae868d61349afa8f0e250108f8e47"><a name="en-us_topic_0000001058460515_aed6ae868d61349afa8f0e250108f8e47"></a><a name="en-us_topic_0000001058460515_aed6ae868d61349afa8f0e250108f8e47"></a>string</p>
+    </td>
+    <td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="en-us_topic_0000001058460515_ab72ac8cc02e34da4b717ca144fc521c1"><a name="en-us_topic_0000001058460515_ab72ac8cc02e34da4b717ca144fc521c1"></a><a name="en-us_topic_0000001058460515_ab72ac8cc02e34da4b717ca144fc521c1"></a>Yes</p>
+    </td>
+    <td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="en-us_topic_0000001058460515_ac53e6549d32f413e9c51cd8a53f4650a"><a name="en-us_topic_0000001058460515_ac53e6549d32f413e9c51cd8a53f4650a"></a><a name="en-us_topic_0000001058460515_ac53e6549d32f413e9c51cd8a53f4650a"></a>Text to print</p>
+    </td>
+    </tr>
+    </tbody>
+    </table>
+
+-   Example
+
+    ```
+    var versionCode = 1;
+    console.info('Hello World. The current version code is ' + versionCode);
+    ```
+
+    Switch to the  **HiLog**  window at the bottom of HUAWEI DevEco Studio. Specifically, select the current device and process, set the log level to  **Info**, and enter  **Hello World**  in the search box. Logs that meet the search criteria are displayed, as shown in the following figure.
+
+    ![](figures/log.png)
+
+    > **NOTE:** 
+    >The  **console.log\(\)**  function prints logs at the debug level.
+
+

en/application-dev/js-reference/apis/globalization.md

+# Globalization<a name="EN-US_TOPIC_0000001115814852"></a>
+
+
+## Imported Modules<a name="en-us_topic_0000001103315838_s56d19203690d4782bfc74069abb6bd71"></a>
+
+```
+import Intl from '@ohos.intl';
+```
+
+## Permissions<a name="en-us_topic_0000001103315838_section11257113618419"></a>
+
+None.
+
+## Class<a name="en-us_topic_0000001103315838_section1956131218111"></a>
+
+## Locale<a name="en-us_topic_0000001103315838_section189341937163212"></a>
+
+Provides APIs for obtaining locale information.
+
+### Attributes<a name="en-us_topic_0000001103315838_section23751576140"></a>
+
+<a name="en-us_topic_0000001103315838_table728861911417"></a>
+<table><thead align="left"><tr id="en-us_topic_0000001103315838_row62887198149"><th class="cellrowborder" valign="top" width="15.870000000000001%" id="mcps1.1.6.1.1"><p id="en-us_topic_0000001103315838_p928811911410"><a name="en-us_topic_0000001103315838_p928811911410"></a><a name="en-us_topic_0000001103315838_p928811911410"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="10.86%" id="mcps1.1.6.1.2"><p id="en-us_topic_0000001103315838_p8288191916149"><a name="en-us_topic_0000001103315838_p8288191916149"></a><a name="en-us_topic_0000001103315838_p8288191916149"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="9.34%" id="mcps1.1.6.1.3"><p id="en-us_topic_0000001103315838_p14288131911418"><a name="en-us_topic_0000001103315838_p14288131911418"></a><a name="en-us_topic_0000001103315838_p14288131911418"></a>Readable</p>
+</th>
+<th class="cellrowborder" valign="top" width="11.51%" id="mcps1.1.6.1.4"><p id="en-us_topic_0000001103315838_p1928861921411"><a name="en-us_topic_0000001103315838_p1928861921411"></a><a name="en-us_topic_0000001103315838_p1928861921411"></a>Writable</p>
+</th>
+<th class="cellrowborder" valign="top" width="52.42%" id="mcps1.1.6.1.5"><p id="en-us_topic_0000001103315838_p728815191149"><a name="en-us_topic_0000001103315838_p728815191149"></a><a name="en-us_topic_0000001103315838_p728815191149"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0000001103315838_row528891919142"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="en-us_topic_0000001103315838_p3288191991414"><a name="en-us_topic_0000001103315838_p3288191991414"></a><a name="en-us_topic_0000001103315838_p3288191991414"></a>language</p>
+</td>
+<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="en-us_topic_0000001103315838_p3288121901418"><a name="en-us_topic_0000001103315838_p3288121901418"></a><a name="en-us_topic_0000001103315838_p3288121901418"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="en-us_topic_0000001103315838_p182881319191414"><a name="en-us_topic_0000001103315838_p182881319191414"></a><a name="en-us_topic_0000001103315838_p182881319191414"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="en-us_topic_0000001103315838_p1928801914148"><a name="en-us_topic_0000001103315838_p1928801914148"></a><a name="en-us_topic_0000001103315838_p1928801914148"></a>No</p>
+</td>
+<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="en-us_topic_0000001103315838_p1428811192144"><a name="en-us_topic_0000001103315838_p1428811192144"></a><a name="en-us_topic_0000001103315838_p1428811192144"></a>Indicates the language of the locale.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0000001103315838_row11288719111417"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="en-us_topic_0000001103315838_p10288419131415"><a name="en-us_topic_0000001103315838_p10288419131415"></a><a name="en-us_topic_0000001103315838_p10288419131415"></a>script</p>
+</td>
+<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="en-us_topic_0000001103315838_p91710563611"><a name="en-us_topic_0000001103315838_p91710563611"></a><a name="en-us_topic_0000001103315838_p91710563611"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="en-us_topic_0000001103315838_p14171165163611"><a name="en-us_topic_0000001103315838_p14171165163611"></a><a name="en-us_topic_0000001103315838_p14171165163611"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="en-us_topic_0000001103315838_p1017115543612"><a name="en-us_topic_0000001103315838_p1017115543612"></a><a name="en-us_topic_0000001103315838_p1017115543612"></a>No</p>
+</td>
+<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="en-us_topic_0000001103315838_p3171125183610"><a name="en-us_topic_0000001103315838_p3171125183610"></a><a name="en-us_topic_0000001103315838_p3171125183610"></a>Indicates the script of the locale.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0000001103315838_row19687050183612"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="en-us_topic_0000001103315838_p32281883406"><a name="en-us_topic_0000001103315838_p32281883406"></a><a name="en-us_topic_0000001103315838_p32281883406"></a>region</p>
+</td>
+<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="en-us_topic_0000001103315838_p1522810854016"><a name="en-us_topic_0000001103315838_p1522810854016"></a><a name="en-us_topic_0000001103315838_p1522810854016"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="en-us_topic_0000001103315838_p1422858124014"><a name="en-us_topic_0000001103315838_p1422858124014"></a><a name="en-us_topic_0000001103315838_p1422858124014"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="en-us_topic_0000001103315838_p1922817874013"><a name="en-us_topic_0000001103315838_p1922817874013"></a><a name="en-us_topic_0000001103315838_p1922817874013"></a>No</p>
+</td>
+<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="en-us_topic_0000001103315838_p1722818834016"><a name="en-us_topic_0000001103315838_p1722818834016"></a><a name="en-us_topic_0000001103315838_p1722818834016"></a>Indicates the region of the locale.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0000001103315838_row115871535369"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="en-us_topic_0000001103315838_p15801188114019"><a name="en-us_topic_0000001103315838_p15801188114019"></a><a name="en-us_topic_0000001103315838_p15801188114019"></a>baseName</p>
+</td>
+<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="en-us_topic_0000001103315838_p108011082401"><a name="en-us_topic_0000001103315838_p108011082401"></a><a name="en-us_topic_0000001103315838_p108011082401"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="en-us_topic_0000001103315838_p138011980407"><a name="en-us_topic_0000001103315838_p138011980407"></a><a name="en-us_topic_0000001103315838_p138011980407"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="en-us_topic_0000001103315838_p1980128134011"><a name="en-us_topic_0000001103315838_p1980128134011"></a><a name="en-us_topic_0000001103315838_p1980128134011"></a>No</p>
+</td>
+<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="en-us_topic_0000001103315838_p1801208144012"><a name="en-us_topic_0000001103315838_p1801208144012"></a><a name="en-us_topic_0000001103315838_p1801208144012"></a>Indicates the basic locale information, which is returned as a substring of a complete locale string.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+### Locale<a name="en-us_topic_0000001103315838_section1410593619146"></a>
+
+A constructor used to create a  **Locale**  object.
+
+**Parameters**
+
+<a name="en-us_topic_0000001103315838_table114831131512"></a>
+<table><thead align="left"><tr id="en-us_topic_0000001103315838_row914851141517"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="en-us_topic_0000001103315838_p214819113159"><a name="en-us_topic_0000001103315838_p214819113159"></a><a name="en-us_topic_0000001103315838_p214819113159"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="en-us_topic_0000001103315838_p1214921121519"><a name="en-us_topic_0000001103315838_p1214921121519"></a><a name="en-us_topic_0000001103315838_p1214921121519"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="en-us_topic_0000001103315838_p11491711141512"><a name="en-us_topic_0000001103315838_p11491711141512"></a><a name="en-us_topic_0000001103315838_p11491711141512"></a>Mandatory</p>
+</th>
+<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="en-us_topic_0000001103315838_p171491011171512"><a name="en-us_topic_0000001103315838_p171491011171512"></a><a name="en-us_topic_0000001103315838_p171491011171512"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0000001103315838_row91491211131519"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="en-us_topic_0000001103315838_p45271354164919"><a name="en-us_topic_0000001103315838_p45271354164919"></a><a name="en-us_topic_0000001103315838_p45271354164919"></a>locale</p>
+</td>
+<td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="en-us_topic_0000001103315838_p1252795444917"><a name="en-us_topic_0000001103315838_p1252795444917"></a><a name="en-us_topic_0000001103315838_p1252795444917"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="en-us_topic_0000001103315838_p314916118154"><a name="en-us_topic_0000001103315838_p314916118154"></a><a name="en-us_topic_0000001103315838_p314916118154"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="en-us_topic_0000001103315838_p814951171516"><a name="en-us_topic_0000001103315838_p814951171516"></a><a name="en-us_topic_0000001103315838_p814951171516"></a>Indicates a character string containing the locale information, including the language and optionally the script and region.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Example**
+
+```
+var enLatnGB = new Intl.Locale("en-Latn-GB");
+var enGB = new Intl.Locale("en-GB");
+var en = new Intl.Locale("en");
+```
+
+## DateTimeFormat<a name="en-us_topic_0000001103315838_section88061769522"></a>
+
+Provides the API for formatting date strings.
+
+### DateTimeFormat<a name="en-us_topic_0000001103315838_section28081362523"></a>
+
+A constructor used to create a  **DateTimeFormat**  object.
+
+**Parameters**
+
+<a name="en-us_topic_0000001103315838_table1680806175216"></a>
+<table><thead align="left"><tr id="en-us_topic_0000001103315838_row10808868524"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="en-us_topic_0000001103315838_p108080625215"><a name="en-us_topic_0000001103315838_p108080625215"></a><a name="en-us_topic_0000001103315838_p108080625215"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="en-us_topic_0000001103315838_p78089645215"><a name="en-us_topic_0000001103315838_p78089645215"></a><a name="en-us_topic_0000001103315838_p78089645215"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="en-us_topic_0000001103315838_p17808126175217"><a name="en-us_topic_0000001103315838_p17808126175217"></a><a name="en-us_topic_0000001103315838_p17808126175217"></a>Mandatory</p>
+</th>
+<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="en-us_topic_0000001103315838_p15808106185212"><a name="en-us_topic_0000001103315838_p15808106185212"></a><a name="en-us_topic_0000001103315838_p15808106185212"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0000001103315838_row19808116205213"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="en-us_topic_0000001103315838_p880815616525"><a name="en-us_topic_0000001103315838_p880815616525"></a><a name="en-us_topic_0000001103315838_p880815616525"></a>locale</p>
+</td>
+<td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="en-us_topic_0000001103315838_p18091655211"><a name="en-us_topic_0000001103315838_p18091655211"></a><a name="en-us_topic_0000001103315838_p18091655211"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="en-us_topic_0000001103315838_p19809196105217"><a name="en-us_topic_0000001103315838_p19809196105217"></a><a name="en-us_topic_0000001103315838_p19809196105217"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="en-us_topic_0000001103315838_p28095613525"><a name="en-us_topic_0000001103315838_p28095613525"></a><a name="en-us_topic_0000001103315838_p28095613525"></a>Indicates a character string containing the locale information, including the language and optionally the script and region, for the <strong id="en-us_topic_0000001103315838_b06014570014"><a name="en-us_topic_0000001103315838_b06014570014"></a><a name="en-us_topic_0000001103315838_b06014570014"></a>DateTimeFormat</strong> object.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Example**
+
+```
+var dateFmt = new Intl.DateTimeFormat("en-Latn-GB");
+```
+
+### format<a name="en-us_topic_0000001103315838_section917151185514"></a>
+
+Obtains the formatted date strings.
+
+**Parameters**
+
+<a name="en-us_topic_0000001103315838_table61711165519"></a>
+<table><thead align="left"><tr id="en-us_topic_0000001103315838_row1176115554"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="en-us_topic_0000001103315838_p017312552"><a name="en-us_topic_0000001103315838_p017312552"></a><a name="en-us_topic_0000001103315838_p017312552"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="en-us_topic_0000001103315838_p217112554"><a name="en-us_topic_0000001103315838_p217112554"></a><a name="en-us_topic_0000001103315838_p217112554"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="en-us_topic_0000001103315838_p61771165517"><a name="en-us_topic_0000001103315838_p61771165517"></a><a name="en-us_topic_0000001103315838_p61771165517"></a>Mandatory</p>
+</th>
+<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="en-us_topic_0000001103315838_p418515559"><a name="en-us_topic_0000001103315838_p418515559"></a><a name="en-us_topic_0000001103315838_p418515559"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0000001103315838_row121811118556"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="en-us_topic_0000001103315838_p13181419559"><a name="en-us_topic_0000001103315838_p13181419559"></a><a name="en-us_topic_0000001103315838_p13181419559"></a>date</p>
+</td>
+<td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="en-us_topic_0000001103315838_p918171185515"><a name="en-us_topic_0000001103315838_p918171185515"></a><a name="en-us_topic_0000001103315838_p918171185515"></a>Date</p>
+</td>
+<td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="en-us_topic_0000001103315838_p161819114551"><a name="en-us_topic_0000001103315838_p161819114551"></a><a name="en-us_topic_0000001103315838_p161819114551"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="en-us_topic_0000001103315838_p718316555"><a name="en-us_topic_0000001103315838_p718316555"></a><a name="en-us_topic_0000001103315838_p718316555"></a>Indicates the <strong id="en-us_topic_0000001103315838_b89491740312"><a name="en-us_topic_0000001103315838_b89491740312"></a><a name="en-us_topic_0000001103315838_b89491740312"></a>Date</strong> object to be formatted.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Return Values**
+
+<a name="en-us_topic_0000001103315838_table2187195518"></a>
+<table><thead align="left"><tr id="en-us_topic_0000001103315838_row618171115511"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="en-us_topic_0000001103315838_p12186185510"><a name="en-us_topic_0000001103315838_p12186185510"></a><a name="en-us_topic_0000001103315838_p12186185510"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="en-us_topic_0000001103315838_p218171115514"><a name="en-us_topic_0000001103315838_p218171115514"></a><a name="en-us_topic_0000001103315838_p218171115514"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0000001103315838_row13181115555"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="en-us_topic_0000001103315838_p3195145512"><a name="en-us_topic_0000001103315838_p3195145512"></a><a name="en-us_topic_0000001103315838_p3195145512"></a>string</p>
+</td>
+<td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="en-us_topic_0000001103315838_p3196119551"><a name="en-us_topic_0000001103315838_p3196119551"></a><a name="en-us_topic_0000001103315838_p3196119551"></a>Indicates a date string formatted based on the specified locale.</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Example**
+
+```
+var date = new Date(1995, 11, 25, 3, 14, 0);
+var datefmt = new Intl.DateTimeFormat("en-Latn-GB");
+var result = datefmt.format(date); // The formatted date string is Dec 25, 1995.
+```
+

en/application-dev/js-reference/apis/screen-brightness.md

+# Screen Brightness<a name="EN-US_TOPIC_0000001162494637"></a>
+
+## Modules to Import<a name="en-us_topic_0000001101127828_s56d19203690d4782bfc74069abb6bd71"></a>
+
+```
+import brightness from '@ohos.brightness.d.ts'.
+```
+
+## Functions<a name="en-us_topic_0000001101127828_section1998783153219"></a>
+
+## setValue\(value: number\)<a name="en-us_topic_0000001101127828_section1853612361618"></a>
+
+Sets the screen brightness.
+
+**Parameters**
+
+<a name="en-us_topic_0000001101127828_table888613685714"></a>
+<table><thead align="left"><tr id="en-us_topic_0000001101127828_row1988683685713"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="en-us_topic_0000001101127828_p1488693625712"><a name="en-us_topic_0000001101127828_p1488693625712"></a><a name="en-us_topic_0000001101127828_p1488693625712"></a>Name</p>
+</th>
+<th class="cellrowborder" valign="top" width="11.64%" id="mcps1.1.5.1.2"><p id="en-us_topic_0000001101127828_p1886173613571"><a name="en-us_topic_0000001101127828_p1886173613571"></a><a name="en-us_topic_0000001101127828_p1886173613571"></a>Type</p>
+</th>
+<th class="cellrowborder" valign="top" width="7.1499999999999995%" id="mcps1.1.5.1.3"><p id="en-us_topic_0000001101127828_p128861336155714"><a name="en-us_topic_0000001101127828_p128861336155714"></a><a name="en-us_topic_0000001101127828_p128861336155714"></a>Mandatory</p>
+</th>
+<th class="cellrowborder" valign="top" width="70.17999999999999%" id="mcps1.1.5.1.4"><p id="en-us_topic_0000001101127828_p3886143617571"><a name="en-us_topic_0000001101127828_p3886143617571"></a><a name="en-us_topic_0000001101127828_p3886143617571"></a>Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0000001101127828_row9886133613577"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="en-us_topic_0000001101127828_p14886163695720"><a name="en-us_topic_0000001101127828_p14886163695720"></a><a name="en-us_topic_0000001101127828_p14886163695720"></a>value</p>
+</td>
+<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.1.5.1.2 "><p id="en-us_topic_0000001101127828_p9886123605716"><a name="en-us_topic_0000001101127828_p9886123605716"></a><a name="en-us_topic_0000001101127828_p9886123605716"></a>number</p>
+</td>
+<td class="cellrowborder" valign="top" width="7.1499999999999995%" headers="mcps1.1.5.1.3 "><p id="en-us_topic_0000001101127828_p988723618577"><a name="en-us_topic_0000001101127828_p988723618577"></a><a name="en-us_topic_0000001101127828_p988723618577"></a>Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="70.17999999999999%" headers="mcps1.1.5.1.4 "><p id="en-us_topic_0000001101127828_p2512184017289"><a name="en-us_topic_0000001101127828_p2512184017289"></a><a name="en-us_topic_0000001101127828_p2512184017289"></a>Brightness value, ranging from 0 to 255</p>
+</td>
+</tr>
+</tbody>
+</table>
+
+**Return Values**
+
+None
+
+-   Example
+
+    ```
+    import brightness from '@ohos.brightness.d.ts'
+    brightness.setValue(128);
+    ```
+
+

en/application-dev/js-reference/custom-components.md

-# Custom Components<a name="EN-US_TOPIC_0000001115974756"></a>
-
--   **[Basic Usage](basic-usage.md)**  
-
--   **[Custom Events](custom-events.md)**  
-
--   **[Props](props.md)**  
-
--   **[Event Parameter](event-parameter.md)**  
-
-