Name
MovieClip.getBytesLoaded( ) Method — check the number of bytes that have downloaded to the Player
Availability
Flash 5
Synopsis
mc.getBytesLoaded( )
Returns
An integer representing the number of bytes of
mc
that have finished downloading to the
Player. (Divide by 1024 to convert to kilobytes.)
Description
The getBytesLoaded( )
method tells us the number
of bytes of a movie that have downloaded into the Flash Player.
However, getBytesLoaded( )
measures bytes in
whole-frame chunks only. So if a movie’s first frame is 200
bytes in size and its second frame is 3000 bytes in size,
getBytesLoaded( )
will return 200 and 3200 but
never any increment in between. Until all of a
given frame has downloaded, the return value of
getBytesLoaded( )
does not change. The
getBytesLoaded( )
method may, therefore, be
thought of as a “bytes version” of the
_framesloaded
property.
Note that internal movie clips are always entirely loaded before they
are displayed, so the return value of getBytesLoaded(
)
on an internal movie clip will always be the same as
getBytesTotal( )
(unless the movie clip is
currently loading an external .swf
file in
response to loadMovie( )
). Therefore,
getBytesLoaded( )
is effective only when used
with a main movie or an external .swf
file being
loaded into an instance or level.
Like _framesloaded
, getBytesLoaded(
)
is normally used to build preloaders. It can be used in
concert with getBytesTotal( )
to create a more
accurate progress bar than is possible with
_framesloaded
and ...
Get ActionScript: The Definitive Guide now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.