คู่มือ API

              
              # iOS SDK API

## GTCaptcha4SessionTaskDelegate

โปรโตคอลตัวแทนงานเซสชันการยืนยัน

### gtCaptchaSession:didReceive:result:

การเรียกกลับสำหรับพารามิเตอร์ผลลัพธ์ของเซสชันการยืนยัน

**การประกาศ**

```objc
- (void)gtCaptchaSession:(GTCaptcha4Session *)captchaSession
              didReceive:(NSString *)status
                  result:(nullable NSDictionary *)result;

            

              
              {
    pass_token = "eb6d2e064524ae96ddc99a0e6e15f95dbb234008d108f0db269f27d426bcf3c6";
    gen_time = "1660894030";
    captcha_output = "fI9I34MDjVi10gJO_EqXwNpN8hK0rYLEPVWSDE4W6kc1umDoTHIlD_t6YQNNpPG2tJlKR8he6WFWkkllU8goGeNVNOzhqmAm256BpK8qAEHNrOjHzkNagfIcx_A21ssPrG6YlnnHFx3PfBnbrn5fb2aKDIi0I5xmCUjxq0dsFuANLIQVtllMjkJ7-1l_j-Wz";
    captcha_id = "647f5ed2ed8acb4be36784e01556bb71";
    lot_number = "0861c607d519469b9117d0c6dd551fe3";
}

            

              
              - (void)gtCaptchaSession:(GTCaptcha4Session *)captchaSession
         didReceiveError:(GTC4Error *)error;

            

              
              @property (nonatomic, weak) id<GTCaptcha4SessionTaskDelegate> delegate;

            

              
              @property (nonnull, readonly, nonatomic, strong) NSString *captchaID;

            

              
              @property (nullable, readonly, nonatomic, strong) NSString *challenge;

            

              
              @property (nonnull, readonly, nonatomic, strong) GTCaptcha4SessionConfiguration *configuration;

            

              
              + (instancetype)sessionWithCaptchaID:(NSString *)captchaID;

            

              
              + (instancetype)sessionWithCaptchaID:(NSString *)captchaID
                       configuration:(nullable GTCaptcha4SessionConfiguration *)configuration;

            

              
              - (instancetype)initWithCaptchaID:(NSString *)captchaID;

            

              
              - (instancetype)initWithCaptchaID:(NSString *)captchaID
                    configuration:(nullable GTCaptcha4SessionConfiguration *)configuration;

            

              
              - (void)verify;

            

              
              - (void)cancel;

            

              
              + (NSString *)sdkVersion;

            

              
              typedef NS_ENUM(NSInteger, GTC4UserInterfaceStyle) {
    /** ตามสไตล์ระบบ */
    GTC4UserInterfaceStyleSystem = 0,
    /** สไตล์สว่าง */
    GTC4UserInterfaceStyleLight,
    /** สไตล์มืด */
    GTC4UserInterfaceStyleDark,
    /** สไตล์เริ่มต้น */
    GTC4UserInterfaceStyleDefault = GTC4UserInterfaceStyleLight
};

            

              
              @property (nullable, nonatomic, strong) NSString *resourcePath;

            

              
              @property (nonatomic, strong) NSString *protocol;

            

              
              @property (nonatomic, assign) GTC4UserInterfaceStyle userInterfaceStyle;

            

              
              @property (nonatomic, strong) UIColor *backgroundColor;

            

              
              @property (nonatomic, assign) BOOL debugEnable;

            

              
              @property (nonatomic, assign) BOOL backgroundUserInteractionEnable;

            

              
              @property (nonatomic, assign) NSTimeInterval timeout;

            

              
              @property (nonatomic, strong) NSString *language;

            

              
              @property (assign, nonatomic) UIInterfaceOrientationMask supportedInterfaceOrientations;

            

              
              @property (nullable, nonatomic, strong) NSDictionary *additionalParameter;

            

              
              #define captchaID @"1234567890abcdef"

GTCaptcha4SessionConfiguration *config = [GTCaptcha4SessionConfiguration defaultConfiguration];

NSMutableDictionary *params = [@{} mutableCopy];
[params setValue:@(1.25)                  forKey:@"rem"]; // ขยายขนาดขึ้น 1.25 เท่า
[params setValue:@[@"close", @"refresh"]  forKey:@"hideBar"]; // ซ่อนปุ่มปิดและรีเฟรช
[params setValue:@"300px"                 forKey:@"nextWidth"];
[params setValue:@"click"                 forKey:@"riskType"]; // ระบุการยืนยันแบบคลิกอัจฉริยะ สอดคล้องกับการตั้งค่าด้านหลัง
[params setValue:@(1)                     forKey:@"hideSuccess"]; // ใช้ NSNumber เพื่อแสดงค่าบูลีน
[params setValue:@"./gt4-loading.gif"     forKey:@"loading"];

config.additionalParameter = params;

GTCaptcha4Session *captchaSession = [GTCaptcha4Session sessionWithCaptchaID:captchaID configuration:config];
...

            

              
              + (GTCaptcha4SessionConfiguration *)defaultConfiguration;

            

              
              + (GTCaptcha4SessionConfiguration *)defaultConfiguration {
    GTCaptcha4SessionConfiguration *config = [[GTCaptcha4SessionConfiguration alloc] init];
    config.debugEnable  = NO;
    config.timeout      = 8.0;
    config.language     = [GTC4Utils systemLanguage];
    config.protocol     = @"https";
    config.userInterfaceStyle = GTC4UserInterfaceStyleDefault;
    config.backgroundColor = [UIColor clearColor];
    config.backgroundUserInteractionEnable = YES;
    
    return config;
}

            

              
              /// พารามิเตอร์ไม่ถูกต้อง โปรดตรวจสอบพารามิเตอร์ที่ป้อน
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeInvalidParameter;
/// การดำเนินการล้มเหลว ตรวจสอบคำอธิบายโดยละเอียด
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeOperationFail;
/// ทรัพยากรหายไป โปรดตรวจสอบว่าไฟล์ GTCaptcha4.bundle สมบูรณ์หรือไม่
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeMissedResource;

/// ผู้ใช้ยกเลิกการยืนยัน
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeUserDidCancel;

/// ล้มเหลวในการโหลดไฟล์ โปรดตรวจสอบว่าไฟล์ GTCaptcha4.bundle สมบูรณ์หรือไม่ หรือทรัพยากรแบบสแตติกที่กำหนดค่าไว้สามารถเข้าถึงได้หรือไม่
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeLoadFileFailure;
/// หมดเวลาการโหลด
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeTimeout;
/// ล้มเหลวในการเรียกใช้สคริปต์ Javascript
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeEvaluatingJavascriptFail;
/// Javascript ส่งคืนข้อผิดพลาด
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeJavascriptError;
/// คำเตือนหน่วยความจำ WebView
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeWebViewMemoryWarning;

/// ข้อผิดพลาดที่ไม่รู้จัก
FOUNDATION_EXPORT NSString * const GTC4ErrorCodeUnknown;

            

              
              @property (readonly, nonatomic, strong) NSString *code;

            

              
              @property (readonly, nonatomic, strong) NSString *msg;

            

              
              @property (readonly, nonatomic, strong) NSDictionary *desc;