5.2. Lib (iOS) - GiGAGenie-VoiceKit/UserGuide GitHub Wiki

1. 음성 녹음/재생 관련

NSString *const UIVoiceAssistCompletePlayNotification = @"UIVoiceAssistCompletePlayNotification"; // 2017.07 JK 재생 완료 Notification 추가.

-(OSStatus) Record:(id)sender withFileName:(CFStringRef) inRecordFileName noEpd:(BOOL) noEPD {

….

}

-(OSStatus) PlayBack:(id)sender withFileName:(CFStringRef) inPalybackFile {

OSStatus recRetErrCode = 0;

if ([[avrController sharedAVRController] IsRunning] == YES) // If we are currently recording, stop and save the file.
{
    [[avrController sharedAVRController] StopPlay];
    recRetErrCode = 1;
}
else
{
    // 2017.07 JK
    if(noErr != (recRetErrCode = [[avrController sharedAVRController] StartPlay:inPalybackFile]))
    {
        UIAlertView * alert = [[UIAlertView alloc] initWithTitle:@"audio error" message:@"you should reboot appliation" delegate:nil cancelButtonTitle:@"확인" otherButtonTitles:nil];
        [alert show];
        [alert release];
    }
}
return recRetErrCode;

}

2. API 인증

2.1 시스템 인증

// 기가지니개발자포털에서 인증한 client(시스템)에 대한 oauth 인증

-(void) SetAuth:(NSString*)userName password:(NSString*) password svcId:(NSString*)svcId keyId:(NSString*)keyId forDelegate:(UIViewController*)view withCallbackBlock:(void(^)(id)) handler

{

// URL Components.

NSURLComponents *components   = [NSURLComponents new];

components.scheme             = @"http";

components.host               = @(KT_AUTH_SERVER_HOST);

components.port               = @(KT_AUTH_SERVER_PORT);

components.path               = @"/oauth/token";



// Authorization header.

NSString *authStr = [NSString stringWithFormat:@"%@:%@", userName, password]; // 발급받은 시스템 유저/비밀번호

NSData *authData = [authStr dataUsingEncoding:NSASCIIStringEncoding];

NSString *authValue = [NSString stringWithFormat:@"Basic %@", [authData base64EncodingWithLineLength:80]];



// 전송 파라메터(POST Type 이지만 Content_Type이 x-www-form-urlencoded이기 때문에 key, value로 body에 파라매터를 입력)

NSURLQueryItem *grantType = [NSURLQueryItem queryItemWithName:@"grant_type" value:@"client_credentials"]; // 인증 유형

components.queryItems = @[ grantType ];



AjaxJson *jsonCon       = [AjaxJson new];



// Key 유효성 조회.

[jsonCon loadPostData:components contentType:X_FORM_URL param:nil withAuthorization:authValue forDelegate:view withCallbackBlock:^(id resObj) {

    // response callback block

    NSString *status           = [resObj objectForKey:@"status"];

    NSString *accessToken      = [resObj objectForKey:@"access_token"];

    

    // 성공

    if(accessToken.length > 0){

        // 응답 정보 저장.

        self.gui_ip = [resObj objectForKey:@"VOICE_API_IP"]; // 음성Client일 경우, 음성시스템에 대한 IP를 제공

        self.gui_port = [[resObj objectForKey:@"VOICE_API_PORT"] intValue];


     // 서비스 키 인증

        [self validationVoiceAPISvcId:svcId keyId:keyId accessToken:accessToken forDelegate:view withCallbackBlock:handler];

    }else{

        NSString *error                 = [resObj objectForKey:@"error"];

        NSString *error_description     = [resObj objectForKey:@"error_description"];

        

        [[MsgHelper new] showError:view title:@"시스템 인증 실패" withErrorMessage:error andDetail:error_description completeCallback:^(UIAlertAction *action) {

        }];

        

        // Callback copy.

        ajaxCompletionHandler  = [handler copy];

        ajaxCompletionHandler(resObj);

    }

}];

}

2.2 사용자 인증

// 기가지니개발자포털에서 발급한 Key(음성API 서비스)에 대한 유효성 검증 API

-(void) validationVoiceAPISvcId:(NSString*)svcId keyId:(NSString*)keyId accessToken:(NSString ) token forDelegate:(UIViewController)view withCallbackBlock:(void(^)(id)) handler

{

// URL Components.

NSURLComponents *components   = [NSURLComponents new];

components.scheme             = @"http";

components.host               = @(KT_AUTH_SERVER_HOST);

components.port               = @(KT_AUTH_SERVER_PORT);

components.path               = [@"/api/voice/v0.9/" stringByAppendingFormat:@"svc/%@/key/%@", svcId, keyId]; // 기가지니개발자포털에서 신청한 API서비스의 id, key id



// Authorization header.

NSString *authValue = [NSString stringWithFormat:@"Bearer %@", token]; // 시스템 인증시 받은 토큰.



// 전송 파라메터(POST Type 이지만 Content_Type이 x-www-form-urlencoded이기 때문에 key, value로 body에 파라매터를 입력)

//NSURLQueryItem *svc = [NSURLQueryItem queryItemWithName:@"svc" value:svcId]; // 기가지니개발자포털에서 신청한 API서비스의 id, key id

//NSURLQueryItem *key = [NSURLQueryItem queryItemWithName:@"key" value:keyId];

//components.queryItems = @[ svc, key ];



AjaxJson *jsonCon       = [AjaxJson new];



// Key 유효성 조회.

[jsonCon loadGetData:components contentType:X_FORM_URL param:nil withAuthorization:authValue forDelegate:view withCallbackBlock:^(id resObj) {

    // response callback block

    NSString *status                 = [resObj objectForKey:@"status"];

    

    // 성공                                                                              

    if([status intValue] == 200){

        [resObj setValue:self.gui_ip forKey:@"VOICE_API_IP"];

        [resObj setValue:@(self.gui_port) forKey:@"VOICE_API_PORT"];

    }else{

        //NSString *resultCode           = [resObj objectForKey:@"resultCode"]; // 전문 설계서에 정의한 코드(현재 다르게 나옴)

        //NSString *resultMessage      = [resObj objectForKey:@"resultMessage"];

        NSString *error                 = [resObj objectForKey:@"error"];

        NSString *message               = [resObj objectForKey:@"message"];

        [[MsgHelper new] showError:view title:@"서비스 키 인증 실패" withErrorMessage:error andDetail:message completeCallback:^(UIAlertAction *action) {

        }];

    }

    

    // Callback copy.

    ajaxCompletionHandler  = [handler copy];

    ajaxCompletionHandler(resObj);

}];

}

2.3 서비스 키 인증

// 시스템 인증 및 음성 인식 서버 정보 조회.

[[VoiceAssistController sharedVoiceAssist] SetAuth:@(KT_ClIENT_ID) password:@(KT_ClIENT_PASSWORD) svcId:@(KT_SERVICE_ID) keyId:@(KT_SERVICE_KEY) forDelegate:self  withCallbackBlock:^(id resObj) {

    

    NSString *statusCode      = [resObj objectForKey:@"statusCode"];

    

    // 음성인식 서버 접속 정보

    self.serverIP = [resObj objectForKey:@"VOICE_API_IP"];

    self.serverPort = [[resObj objectForKey:@"VOICE_API_PORT"] intValue];

    self.serviceKey = 5;

    self.mediaType = 5;

    

    // 성공

    if([statusCode integerValue] == 200){

        // 인식 서버 인증 키 생성.

        self.Certification = [self CertificationKeyMake:self.serviceKey];

        

        NSLog(@"@@@@@ SetParameter serverIP[%@] serverPort[%li] Certification[%@] mediaType[%li]", self.serverIP, (long)self.serverPort, self.Certification, (long)self.mediaType);

        

         // 서비스 키 인증

        if(NO == [[VoiceAssistController sharedVoiceAssist] SetParameter:self.serverIP port:self.serverPort Certification:self.Certification reqcontype:self.mediaType]){

            

            [[MessageHelper new] showError:self title:@"VOICE API 서버 접속 실패" withErrorMessage:@"" andDetail:@"" completeCallback:^(UIAlertAction *action) {

                // setTimeout

                dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{

                    [self.navigationController popToRootViewControllerAnimated:YES]; // go to root view controller

                });

            }];

        }

    }else{

        // setTimeout

        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{

            [self.navigationController popToRootViewControllerAnimated:YES]; // go to root view controller

        });

    }

    

}];