iOS SDK 整合指南

              
              import MTVerify

// 1. 開啟除錯模式（可選，建議在開發階段開啟）
MTVerifySDK.setDebug(true)

// 2. 初始化 SDK
MTVerifySDK.setup(appKey: "your_app_key", environment: .production) { result in
    if result.isSuccess {
        print("SDK 初始化成功")
    } else {
        print("SDK 初始化失敗: \(result.message)")
    }
}

// 3. 檢查覆蓋
MTVerifySDK.checkCoverage(phoneNumber: "6281234567890") { result in
    if result.isSuccess && result.isAvailable {
        print("認證服務可用，電信業者: \(result.operatorCode ?? "")")
    }
}

// 4. 發起認證
MTVerifySDK.startAuthentication(phoneNumber: "6281234567890") { result in
    if result.isSuccess {
        print("認證成功，Token: \(result.token ?? "")")
    }
}

            

              
              @import MTVerify;

// 1. 開啟除錯模式（可選）
[MTVerifySDK setDebug:YES];

// 2. 初始化 SDK
[MTVerifySDK setupWithAppKey:@"your_app_key" 
                 environment:MTEnvironmentProduction 
                  completion:^(MTSetupResult *result) {
    if (result.isSuccess) {
        NSLog(@"SDK 初始化成功");
    } else {
        NSLog(@"SDK 初始化失敗: %@", result.message);
    }
}];

// 3. 檢查覆蓋
[MTVerifySDK checkCoverageWithPhoneNumber:@"6281234567890" 
                               completion:^(MTCoverageResult *result) {
    if (result.isSuccess && result.isAvailable) {
        NSLog(@"認證服務可用，電信業者: %@", result.operatorCode);
    }
}];

// 4. 發起認證
[MTVerifySDK startAuthenticationWithPhoneNumber:@"6281234567890" 
                                     completion:^(MTAuthResult *result) {
    if (result.isSuccess) {
        NSLog(@"認證成功，Token: %@", result.token);
    }
}];

            

              
              static func setDebug(_ enabled: Bool)

            

              
              static func isDebug() -> Bool

            

              
              static func setup(appKey: String,
                  environment: MTEnvironment = .production,
                  completion: @escaping (MTSetupResult) -> Void)

            

              
              static func checkCoverage(phoneNumber: String,
                          completion: @escaping (MTCoverageResult) -> Void)

            

              
              static func startAuthentication(phoneNumber: String,
                                completion: @escaping (MTAuthResult) -> Void)

            

              
              @objc public enum MTEnvironment: Int {
    case sandbox = 0      // 沙箱環境（測試）
    case production = 1   // 正式環境
}

            

              
              @objcMembers
public class MTSetupResult: NSObject {
    /// 結果代碼（0 為成功，其他為失敗）
    public let code: Int
    
    /// 描述資訊
    public let message: String
    
    /// 是否成功
    public var isSuccess: Bool { return code == 0 }
}

            

              
              @objcMembers
public class MTCoverageResult: NSObject {
    /// 結果代碼（0 為成功，其他為失敗）
    public let code: Int
    
    /// 描述資訊
    public let message: String
    
    /// 是否可用
    public let isAvailable: Bool
    
    /// 電信業者代碼
    public let operatorCode: String?
    
    /// 是否成功
    public var isSuccess: Bool { return code == 0 }
}

            

              
              @objcMembers
public class MTAuthResult: NSObject {
    /// 結果代碼（0 為成功，其他為失敗）
    public let code: Int
    
    /// 描述資訊
    public let message: String
    
    /// 認證 Token（用於後端驗證）
    public let token: String?
    
    /// 是否成功
    public var isSuccess: Bool { return code == 0 }
}

            

              
              import UIKit
import MTVerify

class ViewController: UIViewController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 開啟除錯模式
        MTVerifySDK.setDebug(true)
        
        // 初始化 SDK
        initializeSDK()
    }
    
    // MARK: - SDK 初始化
    
    private func initializeSDK() {
        MTVerifySDK.setup(
            appKey: "your_app_key",
            environment: .production
        ) { [weak self] result in
            if result.isSuccess {
                print("✅ SDK 初始化成功")
                print("SDK 版本: \(MTVerifySDK.version)")
                print("是否已初始化: \(MTVerifySDK.isInitialized)")
            } else {
                print("❌ SDK 初始化失敗: \(result.message) (code: \(result.code))")
            }
        }
    }
    
    // MARK: - 檢查覆蓋
    
    func checkCoverage(phoneNumber: String) {
        // 檢查 SDK 是否已初始化
        guard MTVerifySDK.isInitialized else {
            print("⚠️ SDK 未初始化")
            return
        }
        
        MTVerifySDK.checkCoverage(phoneNumber: phoneNumber) { result in
            if result.isSuccess {
                if result.isAvailable {
                    print("✅ 服務可用")
                    print("電信業者: \(result.operatorCode ?? "未知")")
                } else {
                    print("⚠️ 目前環境不支援認證服務")
                }
            } else {
                print("❌ 檢查失敗: \(result.message) (code: \(result.code))")
            }
        }
    }
    
    // MARK: - 發起認證
    
    func authenticate(phoneNumber: String) {
        // 檢查 SDK 是否已初始化
        guard MTVerifySDK.isInitialized else {
            print("⚠️ SDK 未初始化")
            return
        }
        
        MTVerifySDK.startAuthentication(phoneNumber: phoneNumber) { result in
            if result.isSuccess {
                print("✅ 認證成功")
                print("Token: \(result.token ?? "")")
                
                // TODO: 將 token 傳送到後端進行驗證
                self.verifyTokenOnServer(token: result.token ?? "")
                
            } else {
                print("❌ 認證失敗: \(result.message) (code: \(result.code))")
            }
        }
    }
    
    // MARK: - 後端驗證
    
    private func verifyTokenOnServer(token: String) {
        // 將 token 傳送到您的後端伺服器進行驗證
        // 後端使用 token 呼叫 MTVerify 伺服器 API 驗證手機號碼
    }
}