버전: 1.3.x

AI Human 데모

정보

Sample Project에서 아래 파일들을 참고하세요.

DemoView.xaml
DemoViewModel.cs

AI Human SDK Demo는 AIPlayer의 다양한 기능을 살펴볼 수 있는 메뉴입니다. [AI 선택]을 통해 승인된 다른 AI 모델로 변경할 수 있습니다. 기타 자세한 내용은 AIPlayer 설명을 참고하세요.

먼저 사용 가능한 AI 목록을 가져와 UI를 설정합니다. 아래 AIAPI.AppId, AIAPI.UserKey는 HomeView에서 Authenticate를 호출할 때 입력한 매개 변수입니다.

엄밀히 말하면 HomeView에서의 Authenticate는 App.xaml.cs의 생성자에서의 호출을 의미합니다.
초기 Authenticate 호출에 사용한 첫번째, 두번째 인자는 AIAPI.AppId, AIAPI.UserKey에 내부적으로 할당됩니다.

AIAPI.Instance.Authenticate(AIAPI.AppId, AIAPI.UserKey, (aiList, error) =>
{
    try
    {
        if (error != null)
        {
            Application.Current.Dispatcher.BeginInvoke(DispatcherPriority.Render, () => {
                AIStatusText = error.ToString();
            });
            return;
        }

        AIs = new ObservableCollection<AIAPI.AI>();
        foreach (AIAPI.AI item in aiList.ai)
        {
            AIs.Add(item);
        }

        SelectedAI = AIs[0];
    }
    catch (Exception /*e*/)
    {
        AIStatusText = Resource.ApiAiListEmptyError;
    }
});

AI 모델을 변경하는 부분 입니다. AIPlayer를 생성하고 추가하는 것 외에도 샘플 텍스트를 얻어오고 발화 문장 콤보박스를 채웁니다. 나머지 기본 설정값들도 가져와 업데이트됩니다. 자세한 사항은 샘플 프로젝트의 코드를 참고하세요.

private void UpdateSelectedAI()
{
    if (_aiPlayer != null)
    {
        _aiPlayer.Dispose();
        _aiPlayer = null;
    }
    ...

    _aiPlayer = new(SelectedAI.aiName, this);
    AIPlayerObject = _aiPlayer.GetObject();           

    OnPropertyChanged(nameof(AISpeed));
    OnPropertyChanged(nameof(AIScale));

    _aiMargin = AIMargin;
    OnPropertyChanged(nameof(AIMargin_X));
    OnPropertyChanged(nameof(AIMargin_Y));

    _gestures = _aiPlayer.GetGestures();
    ...

    SpeakableLanguages = AIAPI.GetSpeakableLanguages(_aiPlayer.AIGender);
    ...
}

private void UpdateSelectedLanguage()
{
    ...

    AIAPI.Instance.GetSampleTextList(curLang, (texts, err) => { 
        ...
    });
}

다음은 플레이(발화), 프리로드, 일시정지, 재개, 정지 등의 예제입니다.

AIHuman.Core.RelayCommand는 View에서 명령 바인딩(Command Binding)에 사용됩니다. 이 구현은 예세로써 편의를 위해 제공할 뿐 필수적으로 AIHuman.Core.RelayCommand를 사용할 필요는 없습니다.

기타 자세한 내용은 AIPlayer 설명을 참고하세요.

private void Speak_Command(object args)
{
    _sendingMessage.Clear();
    CustomVoice cv;
    if (LanguageIndex == 0)
    {
        cv = CVIndex == 0 ? null : _customVoices[CVIndex - 1];
    }
    else
    {
        cv = _customVoices[CVIndex];
    }

    _aiPlayer.SetCustomVoice(cv);

    AIClipSet clip;
    if (GestureIndex > 0)
    {
        if (GstEnableSpeech)
        {
            clip = AIAPI.CreateClipSet(_speechText, _gestures[GestureIndex - 1].Name);
        }
        else
        {
            clip = AIAPI.CreateClipSet("", _gestures[GestureIndex - 1].Name);
        }
    }
    else
    {
        clip = AIAPI.CreateClipSet(_speechText);
    }
    _sendingMessage.Add(clip);

    _aiPlayer.Send(new[] { clip });
}

private void Preload_Command(object args)
{
    _sendingMessage.Clear();

    AIClipSet clip;
    if (GestureIndex > 0)
    {
        if (GstEnableSpeech)
        {
            clip = AIAPI.CreateClipSet(_speechText, _gestures[GestureIndex - 1].Name);
        }
        else
        {
            clip = AIAPI.CreateClipSet("", _gestures[GestureIndex - 1].Name);
        }
    }
    else
    {
        clip = AIAPI.CreateClipSet(_speechText);
    }

    _sendingMessage.Add(clip);

    _aiPlayer.Preload(new[] { clip });
}

private void Stop_Command(object args)
{
    _aiPlayer.StopSpeaking();
    AIStatusText = Resource.StopStatus;
}

private void Multi_Command(object args)
{
    _sendingMessage.Clear();

    for (int i = 1; i < SpeechList.Count; ++i)
    {
        if (i % 2 != 0)
        {
            _sendingMessage.Add(AIAPI.CreateClipSet(SpeechList[i]));
        }
    }

    _aiPlayer.Send(_sendingMessage.ToArray());
}

private void Resume_Command(object args)
{
    _aiPlayer.Resume();
    AIStatusText = Resource.ResumeStatus;
}

private void Pause_Command(object args)
{
    _aiPlayer.Pause();
    AIStatusText = Resource.PauseStatus;
}

IAIPlayerCallback 구현을 통해, AI 모델 및 AIPlayer의 동작에 대한 콜백을 받을 수 있습니다.

public interface IAIPlayerCallback
{
    void OnAIPlayerError(AIError aiError);
    void OnAIPlayerResLoadingProgressed(int current, int total);
    void OnAIPlayerEvent(AIError aiEvent);
}

예를 들어 OnAIPlayerEvent 구현을 통해 아래와 같은 AI 이벤트 콜백을 받을 수 있습니다.

AIEvent.Type

RES_LOAD_STARTED: AI 리소스 로딩이 시작 되었을 때 발생
RES_LOAD_COMPLETED: AI 리소스 로딩이 완료 되었을 때 발생
AICLIPSET_PLAY_PREPARE_STARTED: AI가 발화 관련 준비 시작 시 발생
AICLIPSET_PLAY_PREPARE_COMPLETED: AI가 발화 관련 준비 완료 시 발생
AICLIPSET_PLAY_STARTED: AI 발화 시작 시 발생
AICLIPSET_PLAY_COMPLETED: AI 발화 완료 시 발생
AICLIPSET_PLAY_FAILED: AI 발화 실패 시 발생
...