Whirled SDK

From Whirled

Jump to: navigation, search

Contents

Herein you will find the latest version of the Whirled SDK as well as release notes.

Download

This is the latest version of the SDK:

http://www.whirled.com/whirled_sdk_0.35.zip

Documentation

Release Notes

Version 0.35 (August 21, 2008)

  • com.whirled.net package for common network operations between current games and future AVRGs.
  • lookup/updateMemory() renamed to get/setMemory().
  • sendChatMessage() renamed to sendChat().
  • Compatibility with Flex 3.1 (EDIT: go ahead and upgrade to flex 3.1, it's free and we will no longer support issues with 3.0)

Version 0.34 (August 7, 2008)

  • Fixed jar file problem with preventing testing games
  • SeatingSubControl.getMyPosition now returns -1 for server agents
  • Some documentation fixes and improvements
  • AVRG APIs moved and slightly refactored but not yet usable

Version 0.33 (August 1, 2008)

  • Server side code is now officially supported
  • Tic-Tac-Toe project has been added as an example of server side code
  • All PROP_* property key constants are now found in EntityControl.

Version 0.32 (July 18, 2008)

  • The RECEIVED_CHAT event has been changed so that the 'name' field of the event now contains the entityId of the speaker, not their String name. Code compiled with an older SDK will continue to receive the name, but new code will have to look up the name if it wants it.
  • The "entity properties" API is fleshed out. Now there are ways to query other sprites in a room for many standard properties
    • the logical or pixel location
    • the layout hotspot
    • the dimensions
    • the type of the entity (furni, avatar, or pet)
    • the name of pets or people
    • the orientation of pets or people
    • and the memberId of people
  • Added EntityControl.getMyEntityId() for finding your own code's entity ID String.
  • getEntityType() was added in 0.30, but has already been removed. Backwards compatibility will not be provided for this one, sorry. Now you may use getEntityProperty(PROP_TYPE, entityId);
  • PetControl.getName() has been removed. Use getEntityProperty(ActorControl.PROP_NAME);
  • Two cool new classes were added to the contrib library: RemoteEntity and Chunker.

Version 0.31 (July 11, 2008)

  • EntityControl fix, which didn't make it into the previous release
  • Documentation updates

Version 0.30 (July 9, 2008)

  • If no locale is provided when using dictionary functions, use en-US.
  • Fixed setting of width and height on in-game headshot graphics
  • Fixed backdrop test viewer
  • Backdrop test viewer now shows a default avatar
  • Fixed avatar in the pet test viewer
  • Documentation improvements
  • Entities may now access properties and detect other entities in the room
  • NOTE: Soon we will be rolling out Server agents, a way for your game to run code on the whirled server. You may notice some reference to this in the SDK documentation, even though it not yet available for general consumption

Version 0.29 (June 18, 2008)

  • DecorControl is now called BackdropControl. If you carry over an old project, you'll need to edit your build.xml and change the "app.type" to "backdrop" instead of decor.
  • In games, restartGameIn() and playerReady() will now throw errors if used in an inappropriate game type (the former is for party games, the latter for seated games)
  • Fixed some issues with testing non-game projects. Since a few versions ago, the viewer was copied to the current directory. Now the file to be tested is copied to dist, and parameters.xml is generated there. For old projects that you carry over, you may delete viewer.swf and parameters.xml from the project directory.
  • The viewer.swf should now handle remixable pets/furni better now, although there are a few issues that may cause errors to be thrown due to it thinking it's connected to whirled. It's a work in progress, we'll probably do another update soon.
  • When testing a game, internal errors will now be logged to chat as well as the trace log.
  • Added SimpleSoundManager to contrib, for managing a global volume level.
  • game/MessageReceivedEvent now contains the id of the user that sent a message.
  • Added getDictionaryWords() to ServicesSubControl.

Version 0.28 (June 10, 2008)

  • Pet, furni, decor, and toy item types now join avatars as being remixable.
  • Avatar states will never be turned to null anymore, but when you read an avatar state, null (the default) will still be transformed into the first registered state, if any.

Version 0.27 (June 3, 2008)

  • In DataPacks, Image and DisplayObject files can now have maxWidth and maxHeight attributes.
  • Size restrictions are now enforced for all entity data. See the API docs for details.
  • Games will now automatically report coins earned to players. If you want to handle this yourself, you must listen for the COINS_AWARDED event and call preventDefault() on it. The function is right on the event object, as it is inherited from flash.events.Event.
  • Include the new imageflipper-remix avatar as an example.
  • Many packages inside contrib were not being included in the SDK, now they are.

Version 0.26 (May 27, 2008)

  • Fixed viewer.swf, now avatar projects should be testable.
  • Changed some things around so avatar projects are testable on the mac.
  • New example avatar: ImageFlipper, which replaced Fairy, which wasn't a good example at all.
  • Added setFrameRate() to GameControl.local so that games can use other frame rates and stage quality settings.
  • A new class was added to contrib: Scoreboard, for easy score handling in a game, showing the scores in the player list.
  • The test game environment should behave more like whirled when players disconnect from the game.
  • Added a new coin payout scheme for games: PROPORTIONAL.

Version 0.25 (May 12, 2008)

  • Fixed a problem that would cause compilation errors with certain projects when compiling against the library source code (as with Flash CS3), rather than the SWCs.
  • Added PetControl.getName().

Version 0.24 (May 8, 2008)

  • For in-room entities (furni, avatars, toys, etc), the function getInstanceId() will now return the viewing user's memberId. Permanent users have memberIds larger than 0. 0 means "invalid or missing", negative numbers refer to guests. More documentation will come when we revamp this method and hopefully make it universal (so that games can access memberIds as well).
  • Games now do not report a player or occupant as having entered until they have fully downloaded and initialized the game media. However, the occupant is still in the room for humans to see (with an italic name).
  • Party games no longer can use the "seating" sub-control. They really shouldn't anyway, but in the past it would cope and return the occupants when you asked for the list of players.
  • Added DecorControl, decor is now a full-fledged room entity.
  • Lots of new stuff added to the 'contrib' packages.

History

Retrieved from "http://wiki.whirled.com/Whirled_SDK"
Personal tools