> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XSpeechToTextBeginHypothesisString

> XSpeechToTextBeginHypothesisString

# XSpeechToTextBeginHypothesisString

가설(hypothesis)을 시작하고 그 문자열을 텍스트 오버레이에 표시합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XSpeechToTextBeginHypothesisString(  
         const char* speakerName,  
         const char* content,  
         XSpeechToTextType type,  
         uint32_t* hypothesisId  
)  
```

<a id="parametersSection" />

### 매개 변수

*speakerName*   \_In\_z\_\
형식: char\*

가설 문자열과 함께 표시할 화자의 이름입니다.

*content*   \_In\_z\_\
형식: char\*

초기 가설 문자열입니다.

*type*   \_In\_\
형식: [XSpeechToTextType](/reference/system/xaccessibility/enums/xspeechtotexttype)

가설 문자열의 원본 유형입니다.

*hypothesisId*   \_Out\_\
형식: uint32\_t\*

가설의 ID입니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

<a id="remarksSection" />

## 설명

가설이란 화자가 말하는 내용에 대한 추측으로, 일반적으로 화자가 문구를 말하는 도중에 음성 인식기가 생성합니다. 음성-텍스트 오버레이 API는 게임 화면 위에 가설 문자열을 표시할 수 있습니다.

음성-텍스트 오버레이 API는 입력한 텍스트도 지원합니다. *type* 매개 변수는 가설 문자열의 원본을 식별합니다.

앱은 가설이 확정되거나 취소될 때까지 *hypothesisId* 값을 유지해야 합니다.

오버레이의 가설 문자열을 업데이트하려면 [XSpeechToTextUpdateHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring)을 사용합니다.

가설을 취소하고 오버레이에서 제거하려면 [XSpeechToTextCancelHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring)을 사용합니다.

가설을 확정하려면 [XSpeechToTextFinalizeHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring)을 사용합니다.

일부 플랫폼에서는 앱이 `XSpeechToTextFinalizeHypothesisString`을 호출할 때까지 가설 문자열이 표시되지 않습니다. 가설이 취소되지 않는 한, 앱은 문자열이 표시되도록 하기 위해 항상 `XSpeechToTextFinalizeHypothesisString`을 호출해야 합니다.

다음 코드 예제는 앱이 가설을 만들고, 업데이트한 다음 확정하는 방법을 보여줍니다.

```cpp theme={null}
void RowanHypothesisSample() 
{ 
    UINT32 hypothesisId; 
    XSpeechToTextBeginHypothesisString("Rowan", "I am typing some text.", XSpeechToTextType::Text, &hypothesisId); 
 
    // 시간이 지납니다. 
 
    XSpeechToTextUpdateHypothesisString(hypothesisId, "I am still typing some text."); 
 
    // 시간이 지납니다. 
 
    XSpeechToTextFinalizeHypothesisString(hypothesisId, "I typed some text. I am done typing."); 
} 
```

다음 코드 예제는 앱이 가설을 만들고, 업데이트한 다음 취소하는 방법을 보여줍니다.

```cpp theme={null}
void QuincyHypothesisSample() 
{ 
    UINT32 hypothesisId; 
    XSpeechToTextBeginHypothesisString("Quincy", "I am speaking some text.", XSpeechToTextType::Voice, &hypothesisId); 
 
    // 시간이 지납니다. 
 
    XSpeechToTextUpdateHypothesisString(hypothesisId, "I am still speaking some text."); 
 
    // 시간이 지납니다. 
 
    XSpeechToTextCancelHypothesisString(hypothesisId); 
} 
```

<a id="requirementsSection" />

## 요구 사항

**헤더:** XAccessibility.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

<a id="seealsoSection" />

## 함께 보기

[XAccessibility](/reference/system/xaccessibility/xaccessibility_members)


## Related topics

- [XSpeechToTextCancelHypothesisString](/ko/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring.md)
- [XSpeechToTextFinalizeHypothesisString](/ko/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)
- [XSpeechToTextUpdateHypothesisString](/ko/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring.md)
- [XAccessibility](/ko/reference/system/xaccessibility/xaccessibility_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)