play

Go to: Synopsis. Flags. Return value. Python examples.

Synopsis

play([forward=boolean], [playSound=boolean], [record=boolean], [sound=string], [state=boolean], [wait=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

play is undoable, queryable, and editable.

Flags

Long name (short name)	[argument types]	Properties
forward(f)	boolean
When true, play back the animation from the currentTime to the maximum of the playback range. When false, play back from the currentTime to the minimum of the playback range. When queried, returns an int. In query mode, this flag needs a value.
state(st)	boolean
start or stop playing back In query mode, this flag needs a value.
record(rec)	boolean
enable the recording system and start one playback loop In query mode, this flag needs a value.
wait(w)	boolean
Wait till completion before returning control to command Window.
sound(s)	string
Specify the sound node to be used during playback In query mode, this flag needs a value.
playSound(ps)	boolean
Specify whether or not sound should be used during playback In query mode, this flag needs a value.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can have multiple arguments, passed either as a tuple or a list.

Return value

Python examples

import maya.cmds as cmds

# Begin playback from min to max
#
cmds.play( forward=True )

# Begin playback from max to min
#
cmds.play( forward=False )

# Stop (forward or backward) playback
#
cmds.play( state=False )

# Record mode through one playback loop
#
cmds.play( record=True )

# Are we playing back?  Returns 1 if yes, 0 if no.
#
cmds.play( q=True, state=True )