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 验证手机号
    }
}