Play メソッド (従来の Windows 環境機能)

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]

Description

指定した文字の指定したアニメーションを再生します。

構文

agent**.文字 ("CharacterID")。Play** "AnimationName"

パーツ	Description
AnimationName	必須。 アニメーション シーケンスの名前を指定する文字列。

 

解説

アニメーションの名前は、Microsoft エージェント文字エディターを使用して文字をコンパイルするときに定義されます。 指定したアニメーションを再生する前に、サーバーは前のアニメーションに対して Return アニメーションを再生しようとします (割り当てられている場合)。

従来のファイル プロトコルを使用してキャラクターのアニメーションにアクセスする場合は、アニメーションの名前を指定する Play メソッドを使用するだけです。 ただし、HTTP プロトコルを使用して文字アニメーション データにアクセスする場合は、Play メソッドを呼び出す前に Get メソッドを使用してアニメーションを読み込みます。

詳細については、 Get メソッドを参照してください。

構文を簡略化するために、オブジェクト参照を宣言し、Characters コレクション内の Character オブジェクトを参照するように設定し、その参照を 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 オブジェクトが返されます。 また、読み込まれていないアニメーションを指定した場合、または文字が正常に読み込まれていない場合、サーバーは Request オブジェクトの Status プロパティを適切なエラー番号で "failed" に設定します。 ただし、アニメーションが存在せず、キャラクターのデータが既に正常に読み込まれている場合、サーバーはエラーを発生させます。

Play メソッドでは、文字が表示されません。 文字が表示されない場合、サーバーはアニメーションを非表示にして再生し、Request オブジェクトの Status プロパティを設定します。