Метод Play (устаревшие функции среды Windows)
[Microsoft Agent является нерекомендуемым начиная с Windows 7 и может быть недоступен в последующих версиях Windows.]
-
Описание
-
Воспроизводит указанную анимацию для указанного символа.
-
Синтаксис
-
агент**. Characters ("CharacterID"). Play** "AnimationName"
Часть | Описание |
---|---|
AnimationName | Обязательный. Строка, указывающая имя последовательности анимации. |
Имя анимации определяется при компиляции символа с помощью редактора символов агента Майкрософт. Перед воспроизведением указанной анимации сервер пытается воспроизвести анимацию возврата для предыдущей анимации, если она была назначена.
При доступе к анимации символа с помощью обычного файлового протокола можно просто использовать метод Play , указав имя анимации. Однако если вы используете протокол HTTP для доступа к данным анимации символов, используйте метод Get , чтобы загрузить анимацию перед вызовом метода Play .
Дополнительные сведения см. в разделе Метод Get .
Чтобы упростить синтаксис, можно объявить ссылку на объект и задать для нее ссылку на объект Character в коллекции Characters и использовать ссылку как часть инструкций Play :
Dim Genie
Agent1.Characters.Load "Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf"
Set Genie = Agent1.Characters ("Genie")
Genie.Get "state", "Showing"
Genie.Show
Genie.Get "animation", "Greet, GreetReturn"
Genie.Play "Greet"
Genie.Speak "Hello."
Если вы объявите ссылку на объект и присвоите ей значение этого метода, он возвращает объект Request . Кроме того, если указать анимацию, которая не загружена, или если символ не был успешно загружен, сервер устанавливает для свойства Status объекта Запроса значение failed с соответствующим номером ошибки. Однако если анимация не существует и данные символа уже успешно загружены, сервер выдает ошибку.
Метод Play не делает символ видимым. Если символ не отображается, сервер воспроизводит анимацию незаметно и задает свойство Status объекта Request .