Merge pull request #451 from AgoraIO/dev/android_chinese_strings

[Android] Replace Chinese comments.

Author: HugoChaan

Android/APIExample-Audio/app/src/main/java/io/agora/api/example/common/widget/WaveformView.java

@@ -69,17 +69,17 @@ private void init(AttributeSet attrs, int defStyle) {
 
     private void initPainters() {
         mWavePaint = new Paint();
-        mWavePaint.setColor(mWaveColor);// 画笔为color
-        mWavePaint.setStrokeWidth(waveStrokeWidth);// 设置画笔粗细
+        mWavePaint.setColor(mWaveColor);// Set paint color
+        mWavePaint.setStrokeWidth(waveStrokeWidth);// Set paint stroke width
         mWavePaint.setAntiAlias(true);
         mWavePaint.setFilterBitmap(true);
         mWavePaint.setStrokeCap(Paint.Cap.ROUND);
         mWavePaint.setStyle(Paint.Style.FILL);
         Shader shader = new LinearGradient(0, 0, 1000, 0, 0xffffffff, 0xFFe850ee, Shader.TileMode.CLAMP);
         mWavePaint.setShader(shader);
         baseLinePaint = new Paint();
-        baseLinePaint.setColor(mBaseLineColor);// 画笔为color
-        baseLinePaint.setStrokeWidth(1f);// 设置画笔粗细
+        baseLinePaint.setColor(mBaseLineColor);// Set paint color
+        baseLinePaint.setStrokeWidth(1f);// Set paint stroke width
         baseLinePaint.setAntiAlias(true);
         baseLinePaint.setFilterBitmap(true);
         baseLinePaint.setStyle(Paint.Style.FILL);
@@ -145,7 +145,7 @@ public void setMaxConstant(boolean maxConstant) {
     }
 
     /**
-     * 如果改变相应配置  需要刷新相应的paint设置
+     * If you change the corresponding configuration, you need to refresh the paint settings
      */
     public void invalidateNow() {
         initPainters();

Android/APIExample-Audio/app/src/main/java/io/agora/api/example/utils/DefaultPoolExecutor.java

@@ -16,7 +16,7 @@
  * Executors
  *
  * @version 1.0
- * @since 16/4/28 下午4:07
+ * @since 16/4/28 4:07 PM
  */
 public class DefaultPoolExecutor extends ThreadPoolExecutor
 {

Android/APIExample-Audio/app/src/main/java/io/agora/api/example/utils/DefaultThreadFactory.java

@@ -12,7 +12,7 @@
  *
  * @author zhilong <a href="mailto:zhilong.liu@aliyun.com">Contact me.</a>
  * @version 1.0
- * @since 15/12/25 上午10:51
+ * @since 15/12/25 10:51 AM
  */
 public class DefaultThreadFactory implements ThreadFactory
 {

Android/APIExample-Audio/app/src/main/java/io/agora/api/example/utils/FileUtils.java

@@ -32,27 +32,27 @@ public static void copyFilesFromAssets(Context context, String assetsPath, Strin
         AssetManager assetManager = context.getAssets();
         try {
             File file = new File(storagePath);
-            if (!file.exists()) {//如果文件夹不存在，则创建新的文件夹
+            if (!file.exists()) {//If the folder does not exist, create a new folder
                 file.mkdirs();
             }
 
-            // 获取assets目录下的所有文件及目录名
+            // Get all file and directory names under assets
             String[] fileNames = assetManager.list(assetsPath);
-            if (fileNames.length > 0) {//如果是目录 apk
+            if (fileNames.length > 0) {//If it's a directory
                 for (String fileName : fileNames) {
                     if (!TextUtils.isEmpty(assetsPath)) {
-                        temp = assetsPath + SEPARATOR + fileName;//补全assets资源路径
+                        temp = assetsPath + SEPARATOR + fileName;//Complete assets resource path
                     }
 
                     String[] childFileNames = assetManager.list(temp);
-                    if (!TextUtils.isEmpty(temp) && childFileNames.length > 0) {//判断是文件还是文件夹：如果是文件夹
+                    if (!TextUtils.isEmpty(temp) && childFileNames.length > 0) {//Check if it's a file or folder: if it's a folder
                         copyFilesFromAssets(context, temp, storagePath + SEPARATOR + fileName);
-                    } else {//如果是文件
+                    } else {//If it's a file
                         InputStream inputStream = assetManager.open(temp);
                         readInputStream(storagePath + SEPARATOR + fileName, inputStream);
                     }
                 }
-            } else {//如果是文件 doc_test.txt或者apk/app_test.apk
+            } else {//If it's a file like doc_test.txt or apk/app_test.apk
                 InputStream inputStream = assetManager.open(assetsPath);
                 if (assetsPath.contains(SEPARATOR)) {//apk/app_test.apk
                     assetsPath = assetsPath.substring(assetsPath.lastIndexOf(SEPARATOR), assetsPath.length());
@@ -66,27 +66,27 @@ public static void copyFilesFromAssets(Context context, String assetsPath, Strin
     }
 
     /**
-     * 读取输入流中的数据写入输出流
+     * Read data from input stream and write to output stream
      *
-     * @param storagePath 目标文件路径
-     * @param inputStream 输入流
+     * @param storagePath Target file path
+     * @param inputStream Input stream
      */
     public static void readInputStream(String storagePath, InputStream inputStream) {
         File file = new File(storagePath);
         try {
             if (!file.exists()) {
-                // 1.建立通道对象
+                // 1. Create channel object
                 FileOutputStream fos = new FileOutputStream(file);
-                // 2.定义存储空间
+                // 2. Define storage space
                 byte[] buffer = new byte[inputStream.available()];
-                // 3.开始读文件
+                // 3. Start reading file
                 int lenght = 0;
-                while ((lenght = inputStream.read(buffer)) != -1) {// 循环从输入流读取buffer字节
-                    // 将Buffer中的数据写到outputStream对象中
+                while ((lenght = inputStream.read(buffer)) != -1) {// Read buffer bytes from input stream in a loop
+                    // Write data from Buffer to outputStream object
                     fos.write(buffer, 0, lenght);
                 }
-                fos.flush();// 刷新缓冲区
-                // 4.关闭流
+                fos.flush();// Flush buffer
+                // 4. Close streams
                 fos.close();
                 inputStream.close();
             }

Android/APIExample-Audio/app/src/main/java/io/agora/api/example/utils/YUVUtils.java

@@ -184,7 +184,7 @@ public static byte[] toWrappedI420(ByteBuffer bufferY,
         return out;
     }
     /**
-     * I420转nv21
+     * Convert I420 to NV21
      */
     public static byte[] I420ToNV21(byte[] data, int width, int height) {
         byte[] ret = new byte[data.length];

Android/APIExample-Audio/app/src/main/res/layout/fragment_ready_layout.xml

@@ -12,7 +12,7 @@
         android:layout_marginTop="24dp"
         android:layout_marginEnd="24dp"
         android:textSize="17sp"
-        android:text="此示例演示了如何使用SDK进行语音通话的功能。"/>
+        android:text="@string/the_example_feature_tips"/>
 
     <androidx.appcompat.widget.AppCompatButton
         android:id="@+id/next"

Android/APIExample-Audio/app/src/main/res/values-zh/strings.xml

@@ -86,4 +86,5 @@
     <string name="audio_route_headset_typec">耳机(TypeC)</string>
     <string name="audio_route_headset_bluetooth">蓝牙耳机</string>
     <string name="notifications_enable_tip">请打开通知权限，防止后台录音中断</string>
+    <string name="the_example_feature_tips">此示例演示了如何使用SDK进行语音通话的功能。</string>
 </resources>

Android/APIExample-Audio/app/src/main/res/values/strings.xml

@@ -94,4 +94,5 @@
     <string name="audio_route_headset_typec">headset(TypeC)</string>
     <string name="audio_route_headset_bluetooth">bluetooth headset</string>
     <string name="notifications_enable_tip">Please turn on notification permission to prevent background recording from being interrupted.</string>
+    <string name="the_example_feature_tips">This example demonstrates how to use the SDK to implement voice call functionality.</string>
 </resources>

Android/APIExample-Compose/app/build.gradle.kts

@@ -35,7 +35,7 @@ android {
         properties.load(rootProject.file("local.properties").inputStream())
         val AGORA_APP_ID = properties.getProperty("AGORA_APP_ID", "")
         if (AGORA_APP_ID == "") {
-            throw GradleException("请在项目根目录下local.properties文件里正确配置：AGORA_APP_ID=<您的声网AppId>")
+            throw GradleException("Please configure correctly in the local.properties file in the project root directory: AGORA_APP_ID=<Your Agora AppId>")
         }
         val AGORA_APP_CERT = properties.getProperty("AGORA_APP_CERT", "")
         buildConfigField("String", "AGORA_APP_ID", "\"$AGORA_APP_ID\"")

Android/APIExample-Compose/app/src/main/java/io/agora/api/example/compose/samples/ChannelEncryption.kt

@@ -172,7 +172,7 @@ fun ChannelEncryption() {
             val allGranted = grantedMap.values.all { it }
             if (allGranted) {
                 // Permission is granted
-                Toast.makeText(context, "Permission Granted", Toast.LENGTH_LONG).show()
+                Toast.makeText(context, R.string.permission_granted, Toast.LENGTH_LONG).show()
 
                 val encryptionConfig = EncryptionConfig()
                 encryptionConfig.encryptionMode = encryptionMode
@@ -194,7 +194,7 @@ fun ChannelEncryption() {
                 }
             } else {
                 // Permission is denied
-                Toast.makeText(context, "Permission Denied", Toast.LENGTH_LONG).show()
+                Toast.makeText(context, R.string.permission_denied, Toast.LENGTH_LONG).show()
             }
         }