คู่มือการผสานรวม Android SDK

              
              <uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

            

              
              <application
    android:networkSecurityConfig="@xml/mtverify_network_security_config"
    ...>
    ...
</application>

            

              
              @JvmStatic
fun init(
    context: Context, 
    appkey: String, 
    environment: IPEnvironment = IPEnvironment.PRODUCTION, 
    callback: InitCallback? = null
)

            

              
              data class InitResult(
    val code: Int,        // รหัสสถานะ; 0 หมายถึงสำเร็จ ตัวเลขอื่นหมายถึงล้มเหลว
    val message: String?  // ข้อความ (ข้อความสำเร็จหรือข้อผิดพลาด)
)

            

              
              MTVerifyApi.init(
    context = this,
    appkey = "your_app_key",
    environment = IPEnvironment.PRODUCTION,
    callback = object : InitCallback {
        override fun onComplete(result: InitResult) {
            if (result.code == 0) {
                // เริ่มต้นสำเร็จ
                Log.d("MTVerify", "เริ่มต้นสำเร็จ: ${result.message}")
            } else {
                // เริ่มต้นล้มเหลว
                Log.e("MTVerify", "เริ่มต้นล้มเหลว: ${result.message}")
            }
        }
    }
)

            

              
              @JvmStatic
fun setLogEnable(enable: Boolean)

            

              
              // เปิดใช้งานบันทึก
MTVerifyApi.setLogEnable(true)

// ปิดบันทึก
MTVerifyApi.setLogEnable(false)

            

              
              @JvmStatic
fun checkCoverage(
    context: Context,
    phoneNumber: String,
    callback: CoverageCallback? = null
)

            

              
              data class CoverageResult(
    val code: Int,           // รหัสสถานะ; 0 หมายถึงสำเร็จ ตัวเลขอื่นหมายถึงล้มเหลว
    val isAvailable: Boolean, // ใช้งานได้หรือไม่ (ผู้ให้บริการที่รองรับ)
    val operatorCode: String?, // รหัสผู้ให้บริการ
    val message: String?      // ข้อความ (ข้อความสำเร็จหรือข้อผิดพลาด)
)

            

              
              MTVerifyApi.checkCoverage(
    context = this,
    phoneNumber = "6281234567890",
    callback = object : CoverageCallback {
        override fun onComplete(result: CoverageResult) {
            if (result.code == 0) {
                if (result.isAvailable) {
                    // รองรับบริการ
                    Log.d("MTVerify", "ผู้ให้บริการรองรับ: ${result.operatorCode}")
                } else {
                    // ไม่รองรับบริการ
                    Log.d("MTVerify", "ผู้ให้บริการไม่รองรับ")
                }
            } else {
                // การตรวจสอบล้มเหลว
                Log.e("MTVerify", "การตรวจสอบล้มเหลว: ${result.message}")
            }
        }
    }
)

            

              
              @JvmStatic
fun startAuthentication(
    activity: Activity,
    countryCode: String,
    phoneNumber: String,
    callback: AuthenticationCallback? = null
)

            

              
              data class AuthenticationResult(
    val code: Int,        // รหัสสถานะ; 0 หมายถึงสำเร็จ, -1 หมายถึงล้มเหลว, -2 หมายถึงผู้ใช้ยกเลิก
    val token: String?,   // ข้อมูลยืนยันตัวตนที่เข้ารหัส (สตริง JSON ที่มี code เข้ารหัสด้วย AES)
    val message: String?  // ข้อความ (ข้อความสำเร็จหรือข้อผิดพลาด)
)

            

              
              {
  "version": "1",
  "content": {
    "code": "รหัสยืนยันตัวตน",
    "state": "พารามิเตอร์สถานะ",
    "appkey": "คีย์แอปพลิเคชัน"
  }
}

            

              
              MTVerifyApi.startAuthentication(
    activity = this,
    countryCode = "62",
    phoneNumber = "81234567890",
    callback = object : AuthenticationCallback {
        override fun onComplete(result: AuthenticationResult) {
            when (result.code) {
                0 -> {
                    // ยืนยันตัวตนสำเร็จ
                    val token = result.token
                    // token ใช้สำหรับแลกเปลี่ยนผลลัพธ์
                    Log.d("MTVerify", "ยืนยันตัวตนสำเร็จ: $token")
                }
                -1 -> {
                    // ยืนยันตัวตนล้มเหลว
                    Log.e("MTVerify", "ยืนยันตัวตนล้มเหลว: ${result.message}")
                }
                -2 -> {
                    // ผู้ใช้ยกเลิก
                    Log.d("MTVerify", "ผู้ใช้ยกเลิกการยืนยันตัวตน")
                }
            }
        }
    }
)

            

              
              enum class IPEnvironment {
    SANDBOX,      // สภาพแวดล้อมทดสอบ/แซนด์บ็อกซ์
    PRODUCTION    // สภาพแวดล้อมการใช้งานจริง
}

            

              
              data class InitResult(
    val code: Int,        // รหัสสถานะ; 0 หมายถึงสำเร็จ
    val message: String?  // ข้อความ
)

            

              
              data class CoverageResult(
    val code: Int,           // รหัสสถานะ; 0 หมายถึงสำเร็จ
    val isAvailable: Boolean, // ใช้งานได้หรือไม่
    val operatorCode: String?, // รหัสผู้ให้บริการ
    val message: String?      // ข้อความ
)

            

              
              data class AuthenticationResult(
    val code: Int,        // รหัสสถานะ; 0 หมายถึงสำเร็จ, -1 หมายถึงล้มเหลว, -2 หมายถึงผู้ใช้ยกเลิก
    val token: String?,   // โทเค็นยืนยันตัวตนที่เข้ารหัส
    val message: String?  // ข้อความ
)

            

              
              interface InitCallback {
    fun onComplete(result: InitResult)
}

            

              
              interface CoverageCallback {
    fun onComplete(result: CoverageResult)
}

            

              
              interface AuthenticationCallback {
    fun onComplete(result: AuthenticationResult)
}

            

              
              class MainActivity : AppCompatActivity() {
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // 1. เปิดใช้งานบันทึก (ไม่บังคับ)
        MTVerifyApi.setLogEnable(true)
        
        // 2. เริ่มต้น SDK
        MTVerifyApi.init(
            context = this,
            appkey = "your_app_key",
            environment = IPEnvironment.SANDBOX,
            callback = object : InitCallback {
                override fun onComplete(result: InitResult) {
                    if (result.code == 0) {
                        // เริ่มต้นสำเร็จ สามารถเริ่มใช้ฟีเจอร์อื่นได้
                        checkCoverage()
                    }
                }
            }
        )
    }
    
    private fun checkCoverage() {
        // 3. ตรวจสอบการรองรับ
        MTVerifyApi.checkCoverage(
            context = this,
            phoneNumber = "6281234567890",
            callback = object : CoverageCallback {
                override fun onComplete(result: CoverageResult) {
                    if (result.isAvailable) {
                        // 4. หากรองรับ ให้ดำเนินการยืนยันตัวตน
                        startAuthentication()
                    }
                }
            }
        )
    }
    
    private fun startAuthentication() {
        // 5. ดำเนินการยืนยันตัวตน
        MTVerifyApi.startAuthentication(
            activity = this,
            countryCode = "62",
            phoneNumber = "81234567890",
            callback = object : AuthenticationCallback {
                override fun onComplete(result: AuthenticationResult) {
                    if (result.code == 0) {
                        // ยืนยันตัวตนสำเร็จ ประมวลผล token
                        handleToken(result.token)
                    }
                }
            }
        )
    }
    
    private fun handleToken(token: String?) {
        // เรียก API เพื่อประมวลผล token ที่แลกเปลี่ยนแล้ว
        
    }
}