Метод 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 .