คู่มือการผสานรวม SDK ของช่องทางผู้ผลิต

              
              buildscript {  
    repositories {  
        mavenCentral()  
    }  
}  

allprojects {
    repositories {  
        mavenCentral()  
    } 
}

            

              
              dependencies {
    // เวอร์ชันของผู้ผลิตควรตรงกับเวอร์ชัน SDK ของ Engagelab
    implementation 'com.engagelab.plugin:mi:5.x.x'
}

            

              
              manifestPlaceholders = [
    // กำหนดตัวแปรในไฟล์ manifest.xml
    XIAOMI_APPKEY : "MI-Your Xiaomi app's APPID", // appkey ที่ลงทะเบียนบนแพลตฟอร์ม Xiaomi
    XIAOMI_APPID : "MI-Your Xiaomi app's APPKEY", // appid ที่ลงทะเบียนบนแพลตฟอร์ม Xiaomi
]

            

              
              -dontwarn com.xiaomi.push.**
-keep class com.xiaomi.push.** { *; }

            

              
              D  [MTMiBusiness] support xiaomi push
D  [MTMiBusiness] onTokenSuccess:get token is Tv3KBknVcnEaXnLe89MGEH3SWVgUYdLDYzJaST30IoIGATl2tv5eu6iuT/PTO0Mj
D  [MTPlatformBusiness] onPlatformTokenSuccess, rid:5, platformToken:
{
    platform=1,
    token=Tv3KBknVcnEaXnLe89MGEH3SWVgUYdLDYzJaST30IoIGATl2tv5eu6iuT/PTO0Mj
    region=NULL
    isUserSettings=false
}

            

              
              buildscript {
    repositories {
        google()
        mavenCentral()
        maven {url 'https://developer.huawei.com/repo/'}
    }
}
buildscript {
    dependencies {
        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
    }
}
allprojects {
    repositories {
        google()
        mavenCentral()
        maven {url 'https://developer.huawei.com/repo/'}
    }
}

            

              
              apmsInstrumentationEnabled=false

            

              
              apply plugin: 'com.huawei.agconnect'

            

              
              dependencies {
    
    implementation 'com.huawei.hms:push:6.11.0.300'
    
    // เวอร์ชันของผู้ผลิตควรตรงกับเวอร์ชัน SDK ของ AppPush
    implementation 'com.engagelab.plugin:huawei:5.x.x'
}

            

              
              signingConfigs {
        release {
            storeFile file("release.keystore") // เส้นทางไปยังไฟล์ลายเซ็น
            storePassword "123456"
            keyAlias "android.keystore"
            keyPassword "123456"
        }
}

buildTypes {
        release {
            minifyEnabled true
            proguardFiles 'proguard-rules.pro'
            signingConfig signingConfigs.release
        }
        debug{
          minifyEnabled false
           signingConfig signingConfigs.release
        }
 }

            

              
              -ignorewarnings
-keepattributes *Annotation* 
-keepattributes Exceptions 
-keepattributes InnerClasses 
-keepattributes Signature 
-keepattributes SourceFile,LineNumberTable 
-keep class com.hianalytics.android.**{*;} 
-keep class com.huawei.updatesdk.**{*;} 
-keep class com.huawei.hms.**{*;}

            

              
              "R.string.hms*",
"R.string.connect_server_fail_prompt_toast",
"R.string.getting_message_fail_prompt_toast",
"R.string.no_available_network_prompt_toast",
"R.string.third_app_*",
"R.string.upsdk_*",
"R.layout.hms*",
"R.layout.upsdk_*",
"R.drawable.upsdk*",
"R.color.upsdk*",
"R.dimen.upsdk*",
"R.style.upsdk*",
"R.string.agc*"

### การตรวจสอบความสำเร็จของการผสานรวม

หากการผสานรวมสำเร็จ บันทึกจะปรากฏดังนี้:

            

              
              
### วิธีการทดสอบช่องทาง Huawei

1. ไปที่ \[EngageLab Console] -> \[AppPush] -> \[Basic Settings] -> \[Integration Settings] หน้าจอ ใส่พารามิเตอร์: AppID, AppSecret และคลิก "Save"

![alt text](https://res.engagelab.net/docs/20250530/092117724/hw2.png)
2\. หลังจากปิดกระบวนการแอป ให้ทำการ push หากได้รับ push การผสานรวมช่องทางผู้ผลิตสำเร็จ

## คู่มือการผสานรวมช่องทาง Meizu

### การตั้งค่า mavenCentral Support

ในไฟล์ gradle หลักของไดเรกทอรี root ของ Project ให้ตั้งค่า mavenCentral support (โครงการใหม่มักจะตั้งค่าการสนับสนุนนี้โดยค่าเริ่มต้น)

            

              
              
### การตั้งค่าการพึ่งพา

ในส่วน `dependencies` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

            

              
              
### การตั้งค่าพารามิเตอร์

ในส่วน `defaultConfig` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

> พารามิเตอร์สำหรับ Meizu ต้องมีคำนำหน้าด้วย "MZ-"

            

              
              
### การตั้งค่าการลบโค้ด

หากใช้ proguard ให้เพิ่มเนื้อหาต่อไปนี้ในไฟล์การตั้งค่าเพื่อป้องกันการรายงานคำเตือนที่ผิดพลาดซึ่งอาจทำให้การคอมไพล์ไม่สำเร็จ:

            

              
              
### การตรวจสอบความสำเร็จของการผสานรวม

หากการผสานรวมสำเร็จ บันทึกจะปรากฏดังนี้:

            

              
              
หากช่องทาง Meizu ไม่สามารถรับ token ได้ ให้ลองเพิ่ม `android.enableR8 = false` ใน `gradle.properties` เพื่อปิดใช้งาน R8

### วิธีการทดสอบช่องทางผู้ผลิต Meizu

1. ไปที่ \[EngageLab Console] -> \[AppPush] -> \[Basic Settings] -> \[Integration Settings] หน้าจอ ใส่พารามิเตอร์: AppKey, AppID, AppSecret และคลิก "Save"
   ![alt text](https://res.engagelab.net/docs/20250530/092117724/mz1.png)

2. หลังจากปิดกระบวนการแอป ให้ทำการ push หากได้รับ push การผสานรวมช่องทางผู้ผลิตสำเร็จ

## คู่มือการผสานรวมช่องทาง Vivo

### การตั้งค่า mavenCentral Support

ในไฟล์ gradle หลักของไดเรกทอรี root ของ Project ให้ตั้งค่า mavenCentral support (โครงการใหม่มักจะตั้งค่าการสนับสนุนนี้โดยค่าเริ่มต้น)

            

              
              
### การตั้งค่าการพึ่งพา

ในส่วน `dependencies` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

            

              
              
### การตั้งค่าพารามิเตอร์

ในส่วน `defaultConfig` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

            

              
              
### การตรวจสอบความสำเร็จของการผสานรวม

หากการผสานรวมสำเร็จ บันทึกจะปรากฏดังนี้:

            

              
              
### การตั้งค่าการลบโค้ด

หากใช้ proguard ให้เพิ่มเนื้อหาต่อไปนี้ในไฟล์การตั้งค่าเพื่อป้องกันการรายงานคำเตือนที่ผิดพลาดซึ่งอาจทำให้การคอมไพล์ไม่สำเร็จ:

            

              
              
### วิธีการทดสอบช่องทาง Vivo

1. ไปที่ \[EngageLab Console] -> \[AppPush] -> \[Basic Settings] -> \[Integration Settings] หน้าจอ ใส่พารามิเตอร์: AppKey, AppID, AppSecret และคลิก "Save"

![alt text](https://res.engagelab.net/docs/20250530/092117724/vv1.png)
2\. หลังจากปิดกระบวนการแอป ให้ทำการ push หากได้รับ push การผสานรวมช่องทางผู้ผลิตสำเร็จ

> หาก Vivo ไม่พร้อมใช้งานในตลาด เมื่อทดสอบการ push คุณจำเป็นต้องเพิ่มอุปกรณ์ทดสอบในแพลตฟอร์ม push ของ Vivo และส่ง push โดยใช้ API พร้อมระบุ `push_mode`


            

              
              
## คู่มือการผสานรวมช่องทาง OPPO

### การตั้งค่า mavenCentral Support

ในไฟล์ gradle หลักของไดเรกทอรี root ของ Project ให้ตั้งค่า mavenCentral support (โครงการใหม่มักจะตั้งค่าการสนับสนุนนี้โดยค่าเริ่มต้น)

            

              
              
### การตั้งค่าการพึ่งพา

ในส่วน `dependencies` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

            

              
              // OPPO ต้องเพิ่มการพึ่งพาต่อไปนี้
implementation 'com.google.code.gson:gson:2.8.9'
implementation 'commons-codec:commons-codec:1.13'
implementation 'androidx.annotation:annotation:1.1.0'

            

              
              
### การตั้งค่าพารามิเตอร์

ในส่วน `defaultConfig` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

> พารามิเตอร์ของ OPPO ต้องมีคำนำหน้าด้วย "OP-"

            

              
              
### การตั้งค่าการลบโค้ด

หากใช้ proguard ให้เพิ่มเนื้อหาต่อไปนี้ในไฟล์การตั้งค่าเพื่อป้องกันการรายงานคำเตือนที่ผิดพลาดซึ่งอาจทำให้การคอมไพล์ไม่สำเร็จ:

            

              
              
### การตรวจสอบความสำเร็จของการผสานรวม

หากการผสานรวมสำเร็จ บันทึกจะปรากฏดังนี้:

            

              
              
### วิธีการทดสอบช่องทาง OPPO

1. ไปที่ \[EngageLab Console] -> \[AppPush] -> \[Basic Settings] -> \[Integration Settings] หน้า, ป้อนพารามิเตอร์: AppKey, AppID, AppSecret, MasterSecret และคลิก "Save"

![alt text](https://res.engagelab.net/docs/20250530/092117724/oppo1.png)
2. หลังจากปิดกระบวนการแอปพลิเคชัน ให้ทำการ Push หากได้รับ Push การรวมช่องทางผู้ผลิตสำเร็จ

> หากแอปไม่พร้อมใช้งาน การทดสอบต้องสมัครสิทธิ์ทดสอบ Push บนแพลตฟอร์ม OPPO แต่ละแอปสามารถ Push ข้อความสาธารณะได้ 1000 ข้อความต่อวัน

## คู่มือการรวมช่องทาง FCM

### การตั้งค่าการสนับสนุน mavenCentral

ในไฟล์ gradle หลักของไดเรกทอรีรากของโปรเจกต์ ให้ตั้งค่าการสนับสนุน mavenCentral และการพึ่งพา google-services

            

              
              
### เพิ่มปลั๊กอิน FCM

ที่ด้านล่างของไฟล์ `build.gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มบรรทัดต่อไปนี้เพื่อเปิดใช้งานปลั๊กอิน gradle:

            

              
              
### การตั้งค่าการพึ่งพา

ในส่วน `dependencies` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

            

              
              
ในส่วน `android` ของไฟล์ `gradle` ของโมดูลแอปพลิเคชัน ให้เพิ่มโค้ดต่อไปนี้:

            

              
              
### การตั้งค่าไฟล์ google-services.json

อ้างอิง \[คู่มือการสมัครพารามิเตอร์ช่องทางผู้ผลิต](https://www.engagelab.com/zh_CN/docs/app-push/developer-guide/client-sdk-reference/android-sdk/application-guide-for-manufacturer-channel-parameters#fcm-%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96) เพื่อรับไฟล์ `google-services.json` และตั้งค่าในไดเรกทอรี `app`

![alt text](https://res.engagelab.net/docs/20250530/092117724/fcm3.png)

### การตั้งค่าไอคอนการแจ้งเตือน FCM

เพิ่มการตั้งค่าต่อไปนี้ในไฟล์ AndroidManifest.xml เพื่อกำหนดไอคอนการแจ้งเตือน FCM:

            

              
              
### การตรวจสอบความสำเร็จของการรวม

หากการรวมสำเร็จ จะมีการแสดงผลลัพธ์ใน log ดังนี้:

            

              
              
### วิธีการทดสอบช่องทาง FCM

1. เงื่อนไขเบื้องต้นสำหรับการทดสอบ:

* ระบบโทรศัพท์ต้องมี Google Play services เวอร์ชัน 17.3.4 หรือสูงกว่า
* การทดสอบต้องเชื่อมต่อกับ VPN ต่างประเทศและตรวจสอบให้แน่ใจว่าเครือข่ายโทรศัพท์สามารถเข้าถึง Google ได้
* หากใช้โทรศัพท์ในประเทศสำหรับการทดสอบ แอปต้องทำงานในพื้นหลัง; การทดสอบจะล้มเหลวหากแอปถูกปิด เนื่องจากผู้ผลิตในประเทศอาจปิดกระบวนการในพื้นหลัง

2. ไปที่ \[EngageLab Console] -> \[AppPush] -> \[Basic Settings] -> \[Integration Settings] หน้า, ป้อนพารามิเตอร์: App Secret และคลิก "Save"
   ![alt text](https://res.engagelab.net/docs/20250530/092117724/fcm1.png)

3. หากทดสอบในประเทศจีน คุณต้องตั้งค่ารหัสประเทศหลังการเริ่มต้น

```java
public class ExampleApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
    
        MTCorePrivatesApi.configDebugMode(this, true);

        // ตั้งค่ารหัสประเทศ -- ไม่ควรตั้งค่านี้ในสภาพแวดล้อมการผลิต
        MTGlobal.setCountryCode("US");
         
        // เริ่มต้น
        MTPushPrivatesApi.init(this);
        
    }
}

            

              
              buildscript {
    repositories {
      ...
      mavenCentral()
      ...
    }
}

allprojets {
    repositories {
        ...
        mavenCentral()
        ...
    }
}

            

              
                defaultConfig {
        ...
        manifestPlaceholders = [
               ...
               HONOR_APPID : "Your Honor app's APP ID", // APP ID ที่ลงทะเบียนในแพลตฟอร์ม Honor
               ...
        ]
        ...
    }
  dependencies {
        ...
        // เวอร์ชันผู้ผลิตควรตรงกับเวอร์ชัน AppPush SDK
        implementation 'com.engagelab.plugin:honor:5.x.x' 
        implementation 'com.engagelab.plugin:honor_th_push:5.x.x'
        ...
  }

            

              
              
D  [MTHonorBusiness] support honor push
D  [MTHonorBusiness] onTokenSuccess:get token is s18069ps301291893q1ssro2o40s1630-n262n542r9669q62o83s390306179rro-775875632-654-6105326555582-PA-0052993947080949113-5
D  [MTPlatformBusiness] onPlatformTokenSuccess, rid:5, platformToken:
{
    platform=7,
    token=s18069ps301291893q1ssro2o40s1630-n262n542r9669q62o83s390306179rro-775875632-654-6105326555582-PA-0052993947080949113-5
    region=NULL
    isUserSettings=false
}

            

              
              
-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.hihonor.push.**{*;}
  

            

              
                  /**
     * รายงานการแจ้งเตือนช่องทางผู้ผลิตที่มาถึง
     * 
     * รายงานผ่าน http/https
     *
     * @param context           ต้องไม่เป็น null
     * @param messageId         EngageLab message id, ต้องไม่เป็น null
     * @param platform          ผู้ผลิต, ค่า (1:mi, 2:huawei, 3:meizu, 4:oppo, 5:vivo, 8:google)
     * @param platformMessageId message id ของผู้ผลิต, สามารถเป็น null ได้
     */
    public static void reportNotificationArrived(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  /**
     * รายงานการคลิกการแจ้งเตือนช่องทางผู้ผลิต
     * 
     * รายงานผ่าน http/https
     *
     * @param context           ต้องไม่เป็น null
     * @param messageId         EngageLab message id, ต้องไม่เป็น null
     * @param platform          ผู้ผลิต, ค่า (1:mi, 2:huawei, 3:meizu, 4:oppo, 5:vivo, 7:honor, 8:google)
     * @param platformMessageId message id ของผู้ผลิต, สามารถเป็น null ได้
     */
    public static void reportNotificationClicked(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  /**
     * รายงานการลบการแจ้งเตือนช่องทางผู้ผลิต
     * 
     * รายงานผ่าน http/https
     *
     * @param context           ต้องไม่เป็น null
     * @param messageId         EngageLab message id, ต้องไม่เป็น null
     * @param platform          ผู้ผลิต, ค่า (1:mi, 2:huawei, 3:meizu, 4:oppo, 5:vivo, 7:honor, 8:google)
     * @param platformMessageId message id ของผู้ผลิต, สามารถเป็น null ได้
     */
    public static void reportNotificationDeleted(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  /**
     * รายงานการเปิดการแจ้งเตือนช่องทางผู้ผลิต
     * 
     * รายงานผ่าน http/https
     *
     * @param context           ต้องไม่เป็น null
     * @param messageId         EngageLab message id, ต้องไม่เป็น null
     * @param platform          ผู้ผลิต, ค่า (1:mi, 2:huawei, 3:meizu, 4:oppo, 5:vivo, 7:honor, 8:google)
     * @param platformMessageId message id ของผู้ผลิต, สามารถเป็น null ได้
     */
    public static void reportNotificationOpened(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  /**
     * อัปโหลด token ของผู้ผลิต
     *
     * ต้องเรียกหลังจากการเชื่อมต่อ EngageLab long connection สำเร็จ มิฉะนั้นจะไม่ถูกต้อง สถานะการเชื่อมต่อ long connection สำเร็จเมื่อ `MTCommonReceiver.onConnectStatus` callback ส่งคืนค่า true
     * 
     * อัปโหลดผ่าน TCP
     *
     * @param context  ต้องไม่เป็น null
     * @param platform ผู้ผลิต, ค่า (1:mi, 2:huawei, 3:meizu, 4:oppo, 5:vivo, 7:honor, 8:google)
     * @param token    token ที่ส่งคืนโดยผู้ผลิต, ต้องไม่เป็น null
     */
    public static void uploadPlatformToken(Context context, byte platform, String token)