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

              
              # คู่มือการรวมช่องทาง Engagelab
## รับข้อมูลแอปพลิเคชัน
สร้างแอปพลิเคชันในคอนโซล หลังจากสร้างแอปพลิเคชันเสร็จแล้ว จะมีการสร้าง AppKey โดยอัตโนมัติเพื่อระบุแอปพลิเคชันนี้ สำหรับข้อมูลเพิ่มเติม โปรดดูที่ [การตั้งค่าแอปพลิเคชัน](/docs/app-push/console/basic-settings/app-info)
## นำเข้าไลบรารี

- วิธีการแบบแมนนวล  

            

              
              นำเข้า mt-sdk-x.x.x.aar จากโฟลเดอร์ libs ไปยังไดเรกทอรี libs
นำเข้า th-xxx-x.x.x.aar จากโฟลเดอร์ libs ไปยังไดเรกทอรี libs

            

              
              
- วิธีการอัตโนมัติ

            

              
              
<a name="3ac7d74a"></a>


## 2. กำหนดค่า build.gradle

            

              
              defaultConfig {
    // ชื่อแพ็คเกจแอปพลิเคชัน ต้องตรงกับในคอนโซล
    applicationId "com.engagelab.app"
    ...
            
    manifestPlaceholders = [
            // AppKey ต้องตรงกับในคอนโซล และตรงกับ packageName
            ENGAGELAB_PRIVATES_APPKEY : "YourAppKey",
            // ช่องทาง Engagelab สำหรับการวิเคราะห์ช่องทาง
            ENGAGELAB_PRIVATES_CHANNEL: "developer",
            // กระบวนการ Engagelab ที่ SDK ของ Engagelab ทำงานอยู่ หมายเหตุ: ต้องเริ่มต้นด้วย :
            ENGAGELAB_PRIVATES_PROCESS: ":remote",
            
    ]
}

            

              
              
## สร้างคอมโพเนนต์ที่จำเป็น

            

              
              <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.engagelab.app">
        
    <!-- จำเป็น: สิทธิ์อินเทอร์เน็ต -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- ตัวเลือก: การสั่นสำหรับการแจ้งเตือน -->
    <uses-permission android:name="android.permission.VIBRATE" /> 
        
    <application
        android:name="com.engagelab.app.MainApplication"
        android:allowBackup="false"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/Theme.MT"
        android:usesCleartextTraffic="true"
        tools:targetApi="m"> <!-- หากใช้คำขอ HTTP ให้อนุญาต HTTP -->

                .....................................................................................................
                
        <!-- เนื่องจากฟีเจอร์การเชื่อมต่อระยะยาวของคลาสนี้ การประหยัดพลังงานโดยผู้ผลิตอาจปิดบริการที่มีชื่อแพ็กเกจที่มี "Engagelab" โดยตรง -->
        <!-- ดังนั้นนักพัฒนาจำเป็นต้องขยาย com.engagelab.app.component.MTCommonService เพื่อปรับปรุงอัตราการอยู่รอดของการเชื่อมต่อระยะยาวและเพิ่มอัตราการมาถึงของข้อความ -->
        <service
            android:name="com.engagelab.app.component.UserService"
            android:exported="false"
            android:process="${ENGAGELAB_PRIVATES_PROCESS}">
            <intent-filter>
                <action android:name="com.engagelab.privates.intent.USER_SERVICE" />
            </intent-filter>
        </service>

        <!-- ใช้สำหรับรับการเรียกกลับทางธุรกิจของ Engagelab รวมถึงสถานะการเชื่อมต่อระยะยาว/สถานะสวิตช์การแจ้งเตือน/การมาถึงของข้อความแจ้งเตือน/การคลิกข้อความแจ้งเตือน/การลบข้อความแจ้งเตือน/ข้อความที่กำหนดเอง/การเรียกกลับโทเค็นของผู้ให้บริการ -->
        <!-- ไม่จำเป็นต้องกำหนดค่ากระบวนการย่อย การเรียกกลับนี้อยู่ในกระบวนการหลักเพื่อความสะดวกในการดำเนินการทางธุรกิจ -->
        <receiver
            android:name="com.engagelab.app.component.UserReceiver"
            android:exported="false">
            <intent-filter>
                <action android:name="com.engagelab.privates.intent.USER_RECEIVER" />
            </intent-filter>
        </receiver>

    </application>

</manifest>


            

              
              package com.engagelab.app;

import android.app.Application;

import com.engagelab.privates.core.api.Address;
import com.engagelab.privates.core.api.MTCorePrivatesApi;
import com.engagelab.privates.push.api.MTPushPrivatesApi;

/**
 * ใช้เพื่อแสดงการกำหนดค่าของ ENGAGELAB-sdk
 */
public class MainApplication extends Application {

    private static final String TAG = "MainApplication";

    @Override
    public void onCreate() {
        super.onCreate();


        // การกำหนดค่าต้องทำใน application.onCreate ไม่จำเป็นต้องตรวจสอบกระบวนการ SDK มีการตรวจสอบภายใน
        MTCorePrivatesApi.configDebugMode(this, true);

        // สำหรับเวอร์ชันก่อน tag: V3.5.4-newportal-20210823-gamma.57 นักพัฒนาฝั่งหน้าต้องเรียกวิธีนี้ มิฉะนั้นจะมีปัญหาเกี่ยวกับการคลิกแจ้งเตือนเพื่อข้ามไป
        // MTPushPrivatesApi.configOldPushVersion(context.getApplicationContext());

        // เริ่มต้นการแจ้งเตือน
        // MTPushPrivatesApi.init(this);
    }

}

            

              
              package com.engagelab.app.component;

import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.widget.TextView;
import android.widget.Toast;

import com.engagelab.app.R;
import com.engagelab.app.log.ExampleLogger;
import com.engagelab.privates.push.api.MTPushPrivatesApi;
import com.engagelab.privates.push.api.NotificationMessage;
import com.engagelab.privates.push.constants.MTPushConstants;

/**
 * ใช้เพื่อแสดงการคลิกแจ้งเตือนเพื่อข้ามไปยัง activity
 *
 * ตรวจสอบให้แน่ใจว่าไม่ได้เรียก MTPushPrivatesApi.configOldPushVersion(Context) มิฉะนั้นการคลิกแจ้งเตือนจะไม่ไปที่หน้านี้
 * <p>
 * ไม่จำเป็นต้องเรียก MTPushPrivatesApi.reportNotificationOpened(Context, String, byte, String); SDK จัดการภายใน
 */
public class UserActivity400 extends Activity {

    private static final String TAG = "UserActivity400";

    private TextView tvMessage;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_intent);
        tvMessage = findViewById(R.id.tv_message);
        onIntent(getIntent());
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        onIntent(intent);
    }

    private void onIntent(Intent intent) {
        try {
            Toast.makeText(this, TAG, Toast.LENGTH_SHORT).show();
            if (intent == null) {
                return;
            }
            // เริ่มต้นจากเวอร์ชัน 3.4.0 ไม่ได้ใช้ออบเจ็กต์อีกต่อไป ใช้ข้อมูล JSON แทน
            String notificationMessage = intent.getStringExtra("message_json");
            if (notificationMessage == null) {
                return;
            }
            ExampleLogger.d(TAG, "notificationMessage:" + notificationMessage.toString());
            tvMessage.setText(notificationMessage.toString());
        } catch (Throwable throwable) {
            throwable.printStackTrace();
        }
    }
        
}

            

              
              <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.engagelab.app">

    <!-- จำเป็น: สิทธิ์อินเทอร์เน็ต -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- ตัวเลือก: การสั่นสำหรับการแจ้งเตือน -->
    <uses-permission android:name="android.permission.VIBRATE" />

    <application
        android:name="com.engagelab.app.MainApplication"
        android:allowBackup="false"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/Theme.MT"
        android:usesCleartextTraffic="true"
        tools:targetApi="m"> <!-- หากใช้คำขอ HTTP ให้อนุญาต HTTP -->

        ..............................................................

        <!-- ใช้เพื่อแสดงการคลิกแจ้งเตือนเพื่อข้ามไป -->
        <activity
            android:name="com.engagelab.app.component.UserActivity400"
            android:exported="false"
            android:launchMode="singleTask" />

        <!-- ใช้เพื่อแสดงการคลิกแจ้งเตือนด้วยลิงก์ลึก -->
<!--        <activity-->
<!--            android:name="com.engagelab.app.component.UserActivity400"-->
<!--            android:exported="false" >-->
<!--            <intent-filter>-->
<!--                <data android:scheme="YourScheme"/>-->
<!--                <data android:host="YourHost"/>-->
<!--                <action android:name="android.intent.action.VIEW" />-->
<!--                <category android:name="android.intent.category.DEFAULT" />-->
<!--                <category android:name="android.intent.category.BROWSABLE" />-->
<!--            </intent-filter>-->
<!--        </activity>-->

            
        <!-- การตรวจสอบการถ่ายโอนในพื้นที่ที่อนุญาต: เริ่มต้นจาก MTPush 4.2.3 หลังจากกำหนดค่า ENGAGELAB_PRIVATES_TRANSFER SDK จะทำการตรวจสอบในพื้นที่ หากเปิดใช้งานการตรวจสอบในพื้นที่ โปรดกำหนดค่า Activity เป้าหมายที่จะข้ามไปที่นี่ หากมี Activity เป้าหมายหลายรายการ โปรดแยกด้วย / -->
        <meta-data
            android:name="ENGAGELAB_PRIVATES_TRANSFER"
            android:value="com.engagelab.app.component.UserActivity400" />
                
        <!-- ความต้องการของ Google push: ลบออกหากไม่ต้องการช่องทาง Google -->
        <meta-data
            android:name="com.google.firebase.messaging.default_notification_icon"
            android:resource="@drawable/mtpush_notification_icon" />

        <!-- ความต้องการของ Huawei push: ลบออกหากไม่ต้องการช่องทาง Huawei -->
        <meta-data
            android:name="com.huawei.messaging.default_notification_icon"
            android:resource="@drawable/mtpush_notification_icon" />

    </application>

</manifest>