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


recordDevice([cleanup=boolean], [data=boolean], [device=string], [duration=int], [playback=boolean], [state=boolean], [wait=boolean])

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

recordDevice is undoable, queryable, and NOT editable.

Starts and stops server side device recording. The data is recorded at the device rate. Once recorded, the data may be brought into Maya with the applyTake command.

See also: enableDevice, applyTake, readTake, writeTake

Return value


In query mode, return type is based on queried flag.


applyTake, defineDataServer, defineVirtualDevice, enableDevice, filter, movIn, movOut, readTake, writeTake


cleanup, data, device, duration, playback, state, wait
Long name (short name) Argument types Properties
device(d) string createmultiuse
Specifies which device(s) to start record recording. The listed device(s) will start recording regardless of their record enable state.
C: The default is to start recording all devices that are record enabled.
data(da) boolean query
Specifies if the device has recorded data. If the device is recording at the time of query, the flag will return false.
Q: When queried, this flag returns an int.
duration(dr) int createquery
Duration (in seconds) of the recording. When the duration expires, the device will still be in a recording state and must be told to stop recording.
C: The default is 60.
Q: When queried, this flag returns an int.
playback(p) boolean createquery
If any attribute is connected to an animation curve, the animation curve will play back while recording the device(s) including any animation curves attached to attributes being recorded.
C: The default is false.
Q: When queried, this flag returns an int.
wait(w) boolean create
If -p/playback specified, wait until playback completion before returning control to the user. This flag is ignored if -p is not used.
state(st) boolean createquery
Start or stop device recording.
C: The default is true.
Q: When queried, this flag returns an int.
cleanup(c) boolean create
Removes the recorded data from the device.

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.

Python examples

import maya.cmds as cmds

#    Record the clock device for 30 seconds and apply the data.
import time
cmds.recordDevice( device='clock', duration=30 )
time.sleep( 30 )
cmds.recordDevice( device='clock', state=False )
cmds.applyTake( device='clock' )