Поделиться через

IAgentCharacter::P repare

  • Статья

[Microsoft Agent не рекомендуется использовать в Windows 7 и может быть недоступно в последующих версиях Windows.]

HRESULT Prepare(
   long dwType,     // type of animation data to load
   BSTR bszName,    // name of the animation 
   long bQueue,     // queue the request
   long * pdwReqID  // address of request ID
);

Извлекает данные анимации для символа.

  • Возвращает S_OK, чтобы указать, что операция выполнена успешно. Когда функция возвращается, pdwReqID содержит идентификатор запроса.

dwType

Значение, указывающее тип данных анимации для загрузки, который должен быть одним из следующих значений:

значение Описание
const unsigned short PREPARE_ANIMATION = 0;
 Данные анимации символа.
const unsigned short PREPARE_STATE = 1;
 Данные состояния символа.
const unsigned short PREPARE_WAVE = 2
 Звуковой файл символа (. WAV или . LWV) для голосовых выходных данных.

bszName

Имя анимации или состояния.

Имя анимации основано на том, что определено для символа при сохранении с помощью редактора символов Microsoft Agent.

Для состояний значение может быть одним из следующих значений:

Description
"Gesturing" Получение всех анимаций состояния Gesturing .
"GesturingDown" Получение анимаций GesturingDown.
"GesturingLeft" Получение анимаций GesturingLeft.
"GesturingRight" Получение анимаций GesturingRight.
"GesturingUp" Получение анимаций GesturingUp.
"Скрытие" Получение анимаций состояния скрытия.
"Слушание" Получение анимаций состояния слушания.
"Простой" Получение всех анимаций состояния простоя .
"IdlingLevel1" Получение всех анимаций IdlingLevel1 .
"IdlingLevel2" Получение всех анимаций IdlingLevel2 .
"IdlingLevel3" Получение всех анимаций IdlingLevel3 .
"Прослушивание" Получение анимаций состояния прослушивания.
"Перемещение" Чтобы получить все анимации перемещаемого состояния.
"MovingDown" Получение всех движущихся анимаций.
"MovingLeft" Чтобы получить все анимации MovingLeft .
"MovingRight" Получение всех анимаций MovingRight .
"Перемещение" Получение всех анимаций MovingUp .
"Показать" Получение анимации состояния "Отображение ".
"Говорить" Получение анимаций состояния "Речь".

Для. WAV-файлы, задайте bszName в спецификации URL-адреса или файла для файла. WAV-файл. Если спецификация не завершена, она интерпретируется как относительно спецификации, используемой в методе Load .

bQueue

Логическое значение, указывающее, помещает ли сервер запрос на подготовку . True помещает запрос в очередь и приводит к тому, что любой запрос анимации, следующий за ним, будет ожидать загрузки данных анимации. False извлекает данные анимации асинхронно.

pdwReqID

Адрес переменной, которая получает идентификатор запроса подготовки .

При загрузке символа с помощью протокола HTTP (a). Файл ACF) необходимо использовать метод Подготовки для получения данных анимации, прежде чем вы сможете воспроизвести анимацию. Этот метод нельзя использовать, если вы загружаете символ с помощью протокола UNC (a). ACS-файл). Вы также не можете получить HTTP-данные для символа с помощью подготовки , если вы загружаете этот символ с помощью протокола UNC (). Файл символов ACS).

Анимация или звуковые данные, полученные с помощью метода Подготовки , хранятся в кэше браузера. Последующие вызовы будут проверять кэш и, если данные анимации уже есть, элемент управления загружает данные непосредственно из кэша. После загрузки анимация или звуковые данные можно воспроизводить с помощью методов Play или Speak.

Можно указать несколько анимаций и состояний, разделив их запятыми. Однако нельзя смешивать типы в той же инструкции Prepare.