Lingo Dictionary > G-K > getError() |
![]() ![]() ![]() |
getError()
Syntax
member(
whichSWAmember
).getError()
getError(member
whichSWAmember
)
member(
whichFlashmember
).getError()
getError(member
whichFlashmember
)
Description
Function; for Shockwave Audio (SWA) or Flash cast members, indicates whether an error occurred as the cast member streamed into memory and returns a value.
Shockwave Audio cast members have the following possible getError()
integer values and corresponding getErrorString()
messages:
getError() value |
getErrorString() message |
---|---|
0 |
OK |
1 |
memory |
2 |
network |
3 |
playback device |
99 |
other |
Flash movie cast members have the following possible getError
values:
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
When an error occurs as a cast member streams into memory, Director sets the cast member's state property to -1. Use the getError
function to determine what type of error occurred.
Example
This handler uses getError
to determine whether an error involving the Shockwave Audio cast member Norma Desmond Speaks occurred and displays the appropriate error string in a field if it did:
on exitFrame if member("Norma Desmond Speaks").getError() <> 0 then member("Display Error Name").text = member("Norma Desmond \ Speaks").getErrorString() end if end
Example
This handler checks to see whether an error occurred for a Flash cast member named Dali, which was streaming into memory. If an error occurred, and it was a memory error, the script uses the unloadCast
command to try to free some memory; it then branches the playback head to a frame in the Director movie named Artists, where the Flash movie sprite first appears, so Director can again try to load and play the Flash movie. If something other than an out-of-memory error occurred, the script goes to a frame named Sorry, which explains that the requested Flash movie can't be played.
on CheckFlashStatus errorCheck = member("Dali").getError() if errorCheck <> 0 then if errorCheck = #memory then member("Dali").clearError() unloadCast go to frame ("Artists") else go to frame ("Sorry") end if end if end
See also
clearError
, getErrorString()
, state
![]() ![]() ![]() |