==========
[STT.google]
==========

Google Speech To Text 제품에 대한 필수 API 를 정의

--------------
환경설정 
--------------

* Google STT API를 사용하기 위해서는 아래와 같은 순서로, 프로젝트 변환 및 환경 값 설정이 필요 하다.
 
	 .. code-block:: xml

	     가. Google 개발자 계정 생성 및 API 키 획득  
	     나. CocoaPods STT 라이브러리 설치 관련 파일 다운로드
	     다. 샘플 프로젝트 및 CocoaPods 라이브러리 설치
	     다. 모피어스 STT 플러그인에 Google 키 설정

가. Google 개발자 계정 생성 및 API 키 획득  
-------------------------------

	- `Google 클라우드 STT 사이트 <https://cloud.google.com/speech-to-text/>`_.


나. CocoaPods STT 라이브러리 설치 관련 파일 다운로드
-------------------------------

	:download:`STT 라이브러리 설치 관련 파일 다운로드 <../_static/api/3rdParty_iOS/google_stt_cocoapod.zip>`.


다. CocoaPods 설치 및 STT 라이브러리 설치
-------------------------------------
    - CocoaPods 설치 
        터미널을 실행하여 아래의 명령어를 입력

        sudo gem install cocoapods

    - 프로젝트에 pod 라이브러리 적용
        1) 적용할 프로젝트 이름은 'sampleProject' 일 경우 
        2) sampleProject/native/ios/project 폴더에 '나' 항목에서 다운로드 받은 파일을 복사한다.

           ( Podfile, googleapis.podspec, google폴더 )
        3) Podfile을  편집기로 열어 target '프로젝트이름' do 부분을 현재 프로젝트 이름에 맞게 변경한다.

           ( target 'sampleProject' do )
        4) 터미널을 실행하여 sampleProject/native/ios/project 폴더로 이동한다.
        5) pod install 을 실행하여 라이브러리를 설치한다.
        6) 설치가 완료되면 sampleProject.xcworkspace 파일이 생성되며 해당 파일로 프로젝트를 열어 사용한다.


	- `Google 클라우드 제공 STT iOS샘플 링크 <https://github.com/GoogleCloudPlatform/ios-docs-samples/tree/master/speech/Objective-C/Speech-gRPC-Streaming>`_.    
 

라. 모피어스 STT 플러그인에 Google 키 설정 
-------------------------------
	- Library/SpeechRecognitionService.m 파일의 23번째 라인 
	  API_KEY를 '가' 항목에서 부여받은 키로 변경하여 사용한다.


--------------
Google STT API
--------------

Kakao 제품에 대한 3rd Party연동 기능을 제공한다.


.. _statusType:

status Type
------------


============  ===================
Type          Description             
============  ===================
PROCESSING    	진행 중
SUCCESS    		정상 처리됨
FAIL     		처리 중 문제가 발생함
============  ===================


STT 입력 시작  
--------------

.. js:function:: M.plugin('3rd_stt_google').start( setting )

	.. versionchanged:: 2.0.0
	
	:param Object setting: 설정 정보
	:param Function setting.callback: STT결과 콜백 함수
	
	.. js:function:: callback(status, result)
		
	:param String status: 상태 ( :ref:`statusType` )
	:param Object result: STT 결과 
		

Example:

    .. code-block:: javascript
        
        M.plugin('3rd_tts_google').start({
            callback:function(status, result){
                alert(JSON.stringify(result));
             }
        });


STT 입력 종료 
--------------

.. js:function:: M.plugin("3rd_stt_google").stop();

	.. versionchanged:: 2.0.0
	

Example:

    .. code-block:: javascript

		M.plugin("AI_stt_google").stop();