Referenshandbok för ActionScript® 3.0 i Adobe® Flash®-plattformen
Hem  |  Dölj paket och klasslista |  Paket  |  Klasser  |  Nyheter  |  Index  |  Bilagor  |  Varför på engelska?
Filter: AIR 30.0 och tidigare, Flash Player 30.0 och tidigare, Flash Lite 4
Flex 4.6 och tidigare, Flash Pro CS6 och tidigare
Dölj filter
flash.media 

Sound  - AS3

Paketx

Översta nivån
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Språkelement

Globala konstanter
Globala funktioner
Operatorer
Programsatser, nyckelord och direktiv
Specialtyper

Bilagor

Nyheter
Kompilatorfel
Kompileringsvarningar
Körningsfel
Flytta till ActionScript 3
Teckenuppsättningar som stöds
Endast MXML-taggar
Motion XML-element
Timed Text-taggar
Lista över borttagna element
Konstanter för hjälpmedelsimplementering
Använda ActionScript-exempel
Juridiska meddelanden
Paketflash.media
Klasspublic class Sound
ArvSound Inheritance EventDispatcher Inheritance Object
Underklasser SoundAsset

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Med klassen Sound kan du arbeta med ljud i ett program. Med klassen Sound kan du skapa ett Sound-objekt, läsa in och spela upp en extern MP3-fil i det objektet, stänga ljudflödet och få åtkomst till data om ljudet, till exempel information om antal byte i flödet och ID3-metadata. En utförligare kontroll av ljudet utförs via ljudkällan – SoundChannel- eller Microphone-objektet för ljudet – och via egenskaperna i SoundTransform-klassen som kontrollerar ljudet till datorns högtalare.

I Flash Player 10 och senare och AIR 1.5 och senare kan du också använda denna klass för att arbeta med ljud som skapas dynamiskt. I detta fall använder Sound-objektet den funktion du tilldelar till en sampleData-händelsehanterare för att hämta ljuddata. Ljudet spelas upp under det att det hämtas från ett ByteArray-objekt som du fyller på med ljuddata. Du kan använda Sound.extract() för att extrahera ljuddata från ett Sound-objekt. Sedan kan du bearbeta det innan du skriver tillbaka det till strömmen för uppspelning.

Om du vill kontrollera ljud som är inbäddade i en SWF-fil använder du egenskaperna i SoundMixer-klassen.

Obs: ActionScript 3.0 Sound API skiljer sig från ActionScript 2.0. I ActionScript 3.0 kan du inte kontrollera egenskaper för sound-objekt genom att ordna dem hierarkiskt.

Överväg följande säkerhetsmodell när du använder den här klassen:

  • Inläsning och uppspelning av ett ljud tillåts inte om den anropande filen finns i en nätverkssandlåda och ljudfilen som ska läsas in är lokal.
  • Som standard är det inte tillåtet att läsa in och spela upp ett ljud om den anropade filen är lokal och försöker läsa in och spela upp ett fjärrljud. En användare måste ge särskild behörighet som tillåter den här typen av åtkomst.
  • Vissa åtgärder som har med ljud att göra är begränsade. Det går inte att få åtkomst till data i ett inläst ljud med en fil i en annan domän om du inte implementerar en korsdomänprincipfil. Ljudrelaterade API:er som faller under denna begränsning är Sound.id3, SoundMixer.computeSpectrum(), SoundMixer.bufferTime och klassen SoundTransform.

I Adobe AIR begränsas emellertid inte innehåll i säkerhetssandlådan application (innehåll som installeras med AIR-programmet) av de här säkerhetsbegränsningarna.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

Visa exemplen

Relaterade API-element



Publika egenskaper
 EgenskapDefinieras med
  bytesLoaded : uint
[skrivskyddad] Returnerar det tillgängliga antalet byte i det här ljudobjektet.
Sound
  bytesTotal : int
[skrivskyddad] Returnerar det totala antalet byte i det här ljudobjektet.
Sound
 Inheritedconstructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.
Object
  id3 : ID3Info
[skrivskyddad] Ger tillgång till metadata som ingår i en MP3-fil.
Sound
  isBuffering : Boolean
[skrivskyddad] Returnerar buffringsläget för externa MP3-filer.
Sound
  isURLInaccessible : Boolean
[skrivskyddad] Anger om egenskapen Sound.url har trunkerats.
Sound
  length : Number
[skrivskyddad] Det aktuella ljudets varaktighet i millisekunder.
Sound
  url : String
[skrivskyddad] URL:en som ljudet lästes in från.
Sound
Publika metoder
 MetodDefinieras med
  
Sound(stream:URLRequest = null, context:SoundLoaderContext = null)
Skapar ett nytt Sound-objekt.
Sound
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.
EventDispatcher
  
Stänger flödet så att eventuell datanedladdning avbryts.
Sound
 Inherited
Skickar en händelse till händelseflödet.
EventDispatcher
  
extract(target:ByteArray, length:Number, startPosition:Number = -1):Number
Extraherar ljuddata i raw-format från ett Sound-objekt.
Sound
 Inherited
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.
EventDispatcher
 Inherited
Anger om det finns en egenskap angiven för ett objekt.
Object
 Inherited
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.
Object
  
load(stream:URLRequest, context:SoundLoaderContext = null):void
Initierar inläsning av en extern MP3-fil från den angivna URL:en.
Sound
  
läs in MP3-ljudinformation från ett ByteArray-objekt till ett Sound-objekt.
Sound
  
loadPCMFromByteArray(bytes:ByteArray, samples:uint, format:String = "float", stereo:Boolean = true, sampleRate:Number = 44100.0):void
Läs in PCM 32-bitars flyttalsljudinformation för ett ByteArray-objekt till ett Sound-objekt.
Sound
  
play(startTime:Number = 0, loops:int = 0, sndTransform:flash.media:SoundTransform = null):SoundChannel
Skapar ett nytt SoundChannel-objekt som ska spela upp ljudet.
Sound
 Inherited
Anger om den angivna egenskapen finns och är uppräkningsbar.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Tar bort en avlyssnare från EventDispatcher-objektet.
EventDispatcher
 Inherited
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.
Object
 Inherited
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.
Object
 Inherited
Returnerar det angivna objektets strängbeteckning.
Object
 Inherited
Returnerar det angivna objektets primitiva värde.
Object
 Inherited
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.
EventDispatcher
Händelser
 Händelse Sammanfattning Definieras med
 Inherited[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.EventDispatcher
  Skickas när alla data är inlästa.Sound
 Inherited[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.EventDispatcher
  Skickas av ett Sound-objekt när ID3-data finns tillgängligt för ett MP3-ljud.Sound
  Skickas om ett in- eller utdatafel orsakar en misslyckad inläsningsåtgärd.Sound
  Skickas när en inläsning initieras.Sound
  Skickas när data tas emot som ett inläsningsförlopp.Sound
  Skickas när miljön begär nya ljuddata.Sound
Egenskapsdetaljer

bytesLoaded

egenskap
bytesLoaded:uint  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar det tillgängliga antalet byte i det här ljudobjektet. Den här egenskapen är vanligtvis endast användbar för externt inlästa filer.



Implementering
    public function get bytesLoaded():uint

bytesTotal

egenskap 
bytesTotal:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar det totala antalet byte i det här ljudobjektet.



Implementering
    public function get bytesTotal():int

id3

egenskap 
id3:ID3Info  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ger tillgång till metadata som ingår i en MP3-fil.

MP3-ljudfiler kan innehålla ID3-taggar som innehåller metadata för filen. Om ett MP3-ljud du läser in med metoden Sound.load() eller innehåller ID3-taggar kan du avfråga dessa egenskaper. Bara ID3-taggar med teckenuppsättningen UTF-8 stöds.

Flash Player 9 och senare versioner samt AIR har stöd för ID3 2.0-taggar, närmare bestämt 2.3 och 2.4. I följande tabell visas standardtaggarna för ID3 2.0 och den typ av innehåll som taggarna representerar. Egenskapen Sound.id3 ger tillgång till dessa taggar via formatet my_sound.id3.COMM, my_sound.id3.TIME och så vidare. Den första tabellen innehåller en beskrivning av taggar som går att få åtkomst till antingen via ID3 2.0-egenskapsnamnet eller via ActionScript-egenskapsnamnet. Den andra tabellen innehåller en beskrivning av ID3-taggar som stöds med som inte har fördefinierade egenskaper i ActionScript.

ID3 2.0-taggMotsvarande egenskap i klassen Sound
COMMSound.id3.comment
TALBSound.id3.album
TCONSound.id3.genre
TIT2Sound.id3.songName
TPE1Sound.id3.artist
TRCKSound.id3.track
TYERSound.id3.year

Följande tabell innehåller en beskrivning av ID3-taggar som stöds men som inte har fördefinierade egenskaper i klassen Sound. Du får tillgång till dem genom att anropa mySound.id3.TFLT, mySound.id3.TIME och så vidare. Obs! Ingen av dessa taggar stöds i Flash Lite 4.

EgenskapBeskrivning
TFLTFiltyp
TIMETidpunkt
TIT1Beskrivning av innehållsgrupp
TIT2Beskrivning av titel/låtnamn/innehåll
TIT3Textnings-/beskrivningsutveckling
TKEYInitialnyckel
TLANSpråk
TLENLängd
TMEDMedietyp
TOALAlbumets/filmens/showens originaltitel
TOFNOriginalfilnamn
TOLYOriginalets textförfattare
TOPEOriginalartister
TORYUrsprungligt utgivningsår
TOWNFilens ägare/licenstagare
TPE1Huvudartister/solister
TPE2Band/orkester/ackompanjemang
TPE3Dirigent-/artistutveckling
TPE4Tolkad, remixad eller på annat sätt ändrad av
TPOSDel av en serie
TPUBUtgivare
TRCKSpårnummer/plats i en serie
TRDAInspelningsdatum
TRSNNamn på Internet-radiostation
TRSOInternet-radiostationens ägare
TSIZStorlek
TSRCISRC (International Standard Recording Code)
TSSEProgramvara/maskinvara och inställningar som används för kodning
TYERÅr
WXXXURL-länkram

Tänk på Flash Players säkerhetsmodell när du använder den här egenskapen:

  • Egenskapen id3 för ett Sound-objekt tillåts alltid för SWF-filer som finns i samma säkerhetssandlåda som ljudfilen. För filer i andra sandlådor finns det säkerhetskontroller.
  • Om du läser in ljudet med metoden load() i Sound-klassen kan du ange en context-parameter som är ett SoundLoaderContext-objekt. Om du ställer in egenskapen checkPolicyFile för SoundLoaderContext-objektet på true söker Flash Player efter en URL-principfil på den server från vilken ljudet lästes in. Om det finns en principfil och om filen godkänner åtkomst från domänen för den inlästa SWF-filen, får filen åtkomst till id3-egenskapen i Sound-objekt. Annars får den inte åtkomst.

I Adobe AIR begränsas emellertid inte innehåll i säkerhetssandlådan application (innehåll som installeras med AIR-programmet) av de här säkerhetsbegränsningarna.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.



Implementering
    public function get id3():ID3Info

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel läses ID3-information från en ljudfil och visas i ett textfält.

I konstruktorn läses ljudfilen in men den ställs inte in på uppspelning. Här antas filen finnas i SWF-katalogen. Datorn måste ha behörighet för att kunna läsa ID3-taggar i en inläst ljudfil. Om det fins ID3-information i filen och programmet får läsa den aktiveras en Event.ID3-händelse och egenskapen id3 i ljudfilen fylls i. Egenskapen id3 innehåller ett ID3Info-objekt med all ID3-information.

I metoden id3Handler() sparas filens ID3-taggar i id3, ett objekt av klassen ID3Info. En textfältsinstans skapas för att visa listan med ID3-taggar. for-slingan itererar genom alla ID3 2.0-taggar och lägger till deras namn och värden i textfältets innehåll. Med hjälp av egenskaper för ID3-info (ID3Info) läggs även artist, låttitel och album till. ActionScript 3.0 och Flash Player 9 och senare har stöd för ID3 2.0-taggar, specifikt 2.3 och 2.4. Om du itererar genom egenskaper som i for-slingan visas bara ID3 2.0-taggar. Data från tidigare versioner lagras också i låtens id3-egenskap och kan visas med hjälp av egenskaperna i klassen ID3Info. Taggarna för ID3 1.0 finns i slutet av filen medan ID3 2.0-taggar finns i början av filen. (Ibland kan filerna ha både tidigare och senare versioner av taggarna på samma ställe.) Om en fil som är kodad med både version 1.0- och version 2.0-taggar i början och slutet av filen anropas metoden id3Handler() två gånger. Först läses version 2.0 och sedan version 1.0. Om det bara finns ID3 1.0-taggar är informationen tillgänglig via ID3-egenskaperna, till exempel id3.songname. För ID3 2.0 hämtar egenskapen id3.TITS låttiteln med den nya taggen (TITS).

Observera att ingen felhantering har skrivits för det här exemplet och om ID3-innehållet är långt kanske inte resultatet får plats i det synliga området.

package {
    import flash.display.Sprite;
    import flash.media.Sound;
    import flash.net.URLRequest;
    import flash.media.ID3Info;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.events.Event;

    public class Sound_id3Example extends Sprite {
        private var snd:Sound = new Sound();       
        private var myTextField:TextField = new TextField();

        public function Sound_id3Example() {
            snd.addEventListener(Event.ID3, id3Handler);
            snd.load(new URLRequest("mySound.mp3"));
        }
    
        private function id3Handler(event:Event):void {
            var id3:ID3Info = snd.id3;

            myTextField.autoSize = TextFieldAutoSize.LEFT;
            myTextField.border = true;

            myTextField.appendText("Received ID3 Info: \n");
              
            for (var propName:String in id3) {
                myTextField.appendText(propName + " = " + id3[propName] + "\n");
            }
 
            myTextField.appendText("\n" + "Artist: " + id3.artist + "\n");
            myTextField.appendText("Song name: " + id3.songName + "\n");
            myTextField.appendText("Album: " + id3.album + "\n\n"); 
 
            this.addChild(myTextField);
        }
    }
}

isBuffering

egenskap 
isBuffering:Boolean  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar buffringsläget för externa MP3-filer. Om värdet är true är eventuell uppspelning för tillfället inaktiverad medan objektet väntar på mer data.



Implementering
    public function get isBuffering():Boolean

isURLInaccessible

egenskap 
isURLInaccessible:Boolean  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: Flash Player 10.1, AIR 2

Anger om egenskapen Sound.url har trunkerats. När värdet isURLInaccessible är true är värdet Sound.url bara domänen för den slutliga webbadress varifrån ljudet lästes in. Egenskapen är till exempel trunkerad om ljudet läses in från http://www.adobe.com/assets/hello.mp3 och egenskapen Sound.url har värdet http://www.adobe.com. Värdet för isURLInaccessible är bara true om alla följande påståenden stämmer:

  • En HTTP-omdirigering inträffade när ljudfilen lästes in.
  • Den SWF-fil som anropar Sound.load() är från en annan domän än ljudets slutliga webbadress.
  • Den SWF-fil som anropar Sound.load() har inte behörighet att komma åt ljudfilen. Behörighet för ljudfilen ges på samma sätt som för egenskapen Sound.id3: skapa en principfil och använd egenskapen SoundLoaderContext.checkPolicyFile.

Obs! Egenskapen isURLInaccessible har lagts till i Flash Player 10.1 och AIR 2.0, men den här egenskapen är tillgänglig för alla SWF-filer oavsett version när Flash-miljön stöder den. Om du använder vissa utvecklingsverktyg i s.k. strikt läge kan det därför orsaka ett kompileringsfel. Du kan undvika felet genom att använda den indirekta syntaxen mySound["isURLInaccessible"] eller inaktivera strikt läge. Om du använder Flash Professional CS5 eller Flex SDK 4.1 kan du använda och kompilera detta API för körningsmiljöer som släpptes före Flash Player 10.1 och AIR 2.

För programinnehåll i AIR är värdet på den här egenskapen alltid false.



Implementering
    public function get isURLInaccessible():Boolean

Relaterade API-element

length

egenskap 
length:Number  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Det aktuella ljudets varaktighet i millisekunder.



Implementering
    public function get length():Number

url

egenskap 
url:String  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

URL:en som ljudet lästes in från. Den här egenskapen används bara på Sound-objekt som lästs in med metoden Sound.load(). För Sound-objekt som associeras med en ljudresurs från en SWF-fils bibliotek är värdet för egenskapen url null.

Fösta gången du anropar Sound.load() har url-egenskapen till en början ett värde på null eftersom man inte känner till den slutliga URL:en än. Egenskapen url kommer att ha ett värde som inte är null så fort en open-händelse skickas från Sound-objektet.

Egenskapen url innehåller den slutliga, absoluta URL:en som ett ljud läses in från. Värdet för url är oftast samma som värdet som skickas till parametern stream för Sound.load(). Om du skickade en relativ URL till Sound.load() representerar värdet för url-egenskapen den absoluta URL:en. Om den ursprungliga URL-begäran dessutom omdirigeras av en HTTP-server, återspeglar värdet för url-egenskapen den slutliga URL:en som ljudfilen i själva verket har lästs in från. Denna rapportering av en absolut, slutlig URL motsvarar beteendet för LoaderInfo.url.

I vissa fall trunkeras värdet på egenskapen url. Läs mer om detta i avsnittet om egenskapen isURLInaccessible.



Implementering
    public function get url():String

Relaterade API-element

Konstruktordetaljer

Sound

()Konstruktor
public function Sound(stream:URLRequest = null, context:SoundLoaderContext = null)

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skapar ett nytt Sound-objekt. Om du skickar ett giltigt URLRequest-objekt till Sound-konstruktorn anropas funktionen load() för Sound-objektet automatiskt. Om du skickar ett giltigt URLRequest-objekt till Sound-konstruktorn måste du anropa funktionen load() för Sound-objektet, annars läses flödet inte in.

Om load() har anropats för ett Sound-objekt går det inte att senare läsa in en annan ljudfil till det Sound-objektet. Om du vill läsa in en annan ljudfil skapar du ett nytt Sound-objekt.

I Flash Player 10 och senare versioner, samt AIR 1.5 och senare versioner, kan du i stället för att använda load() använda händelsehanteraren sampleData för att läsa in ljud dynamiskt till Sound-objektet.

Parametrar
stream:URLRequest (default = null) — URL:en som pekar på en extern MP3-fil.
 
context:SoundLoaderContext (default = null) — Ett valfritt SoundLoader-kontextobjekt som kan definiera bufferttiden (det minsta antal millisekunder med MP3-data som ska lagras i Sound-objektets buffert) och ange huruvida programmet ska söka efter en korsdomänprincipfil före inläsningen av ljudet.
Metoddetaljer

close

()metod
public function close():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Stänger flödet så att eventuell datanedladdning avbryts. Det går inte att läsa några data från flödet efter att close()-metoden har anropats.


Utlöser
IOError — Dataflödet kunde inte stängas eller så var det inte öppet.

Exempel  ( Så här använder du exemplet )

I följande exempel anropas metoden Sound.close() och direktuppspelningen av ljudet stoppas.

I konstruktorn skapas ett textfält för start- och stoppknappen. När användaren klickar på textfältet anropas metoden clickHandler(). Den hanterar start och stopp för ljudfilen. Beroende på nätverksanslutningen och på när användaren klickar på stoppknappen kan en stor del av filen redan ha lästs in och det kan ta en stund innan ljuduppspelningen avbryts. Ett try...catch-block används för att hantera eventuella IO-fel som kan uppstå när flödet stängs. Om ljudet till exempel läses in från en lokal katalog och inte direktuppspelas uppstår fel 2029, vilket innebär "URLStream-objektet har inget öppet dataflöde".

 
package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;    
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.events.MouseEvent;
    import flash.errors.IOError;
    import flash.events.IOErrorEvent;

    public class Sound_closeExample extends Sprite {
        private var snd:Sound = new Sound();
        private var button:TextField = new TextField();
        private var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
        
        public function Sound_closeExample() {
            button.x = 10;
            button.y = 10;
            button.text = "START";
            button.border = true;
            button.background = true;
            button.selectable = false;
            button.autoSize = TextFieldAutoSize.LEFT;

            button.addEventListener(MouseEvent.CLICK, clickHandler);

            this.addChild(button);
        }

        private function clickHandler(e:MouseEvent):void {

            if(button.text == "START") {

                snd.load(req);
                snd.play();        

                snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);

                button.text = "STOP";
            }
            else if(button.text == "STOP") {
                    
                try {
                    snd.close();
                    button.text = "Wait for loaded stream to finish.";
                }
                catch (error:IOError) {
                    button.text = "Couldn't close stream " + error.message;    
                }
            }
        }
        
        private function errorHandler(event:IOErrorEvent):void {
                button.text = "Couldn't load the file " + event.text;
        }
    }
}


extract

()metod 
public function extract(target:ByteArray, length:Number, startPosition:Number = -1):Number

Språkversion: ActionScript 3.0
Körningsmiljöversioner: Flash Player 10, AIR 1.5

Extraherar ljuddata i raw-format från ett Sound-objekt.

Denna metod är utformad för att användas när du arbetar med dynamiskt skapade ljud. Den använder en funktion som du tilldelar till sampleData-händelsen för ett annat Sound-objekt. Det innebär att du kan använda den här metoden för att extrahera ljuddata från ett Sound-objekt. Sedan kan du skriva dessa data till den bytearray som ett annat Sound-objekt använder för att strömma dynamiskt ljud.

Ljuddata placeras i byte-arrayen med början från den aktuella positionen i byte-arrayen. Ljuddata visas alltid som 44 100 Hz Stereo. Samplingstypen är ett 32-bitars flyttalsvärde som kan konverteras till ett Number-objekt med hjälp av ByteArray.readFloat().

Parametrar

target:ByteArray — Ett ByteArray-objekt i vilket de extraherade ljudsamplingarna placeras.
 
length:Number — Antal ljudsamplingar som ska extraheras. En sampling innehåller både vänster och höger kanal, vilket innebär två 32-bitars flyttalsvärden.
 
startPosition:Number (default = -1) — Samplingen där extraheringen börjar. Om du inte anger ett värde startar det första anropet till Sound.extract() vid början av ljudet. Påföljande anrop utan värde för startPosition angivet går sekventiellt genom filen.

Returnerar
Number — Det antal samplingar som skrivs till den ByteArray som anges i parametern target.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande exempel läser in en mp3-fil och använder metoden extract() från klassen Sound för att komma åt ljuddata.

Dessa mp3-data läses in i Sound-objektet sourceSnd. När programmet läser in mp3-data, anropar det funktionen loaded() (händelsehanteraren för complete-händelsen för sourceSnd-objektet). Ett andra Sound-objekt, outputSound, används för att spela upp det ändrade ljudet. Objektet outputSound har en sampleData-händelseavlyssnare. Objektet skickar därför periodiskt sampleData-händelser när du anropar dess play()-metod. Metoden upOctave() returnerar en bytearray med ändrade ljuddata som baseras på dina källjuddata. Den returnerar ljud som är en oktav högre genom att hoppa över varannan ljudsampling i dess källdata. Händelsehanteraren för sampleData-händelsen skriver den returnerade bytearrayen till data-egenskapen för outputSound-objektet. data-bytearrayen läggs till utdataljuddata för outputSound-objektet.

Testa det här exemplet genom att lägga till en test.mp3-fil i samma katalog som SWF-filen.

var sourceSnd:Sound = new Sound();
var outputSnd:Sound = new Sound();
var urlReq:URLRequest = new URLRequest("test.mp3");

sourceSnd.load(urlReq);
sourceSnd.addEventListener(Event.COMPLETE, loaded);

function loaded(event:Event):void
{
    outputSnd.addEventListener(SampleDataEvent.SAMPLE_DATA, processSound);
    outputSnd.play();
}

function processSound(event:SampleDataEvent):void
{
    var bytes:ByteArray = new ByteArray();
    sourceSnd.extract(bytes, 4096);
    event.data.writeBytes(upOctave(bytes));
}

function upOctave(bytes:ByteArray):ByteArray
{
    var returnBytes:ByteArray = new ByteArray();
    bytes.position = 0;
    while(bytes.bytesAvailable > 0)
    {
        returnBytes.writeFloat(bytes.readFloat());
        returnBytes.writeFloat(bytes.readFloat());
        if (bytes.bytesAvailable > 0)
        {
            bytes.position += 8;
        }
    }
    return returnBytes;
}

load

()metod 
public function load(stream:URLRequest, context:SoundLoaderContext = null):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Initierar inläsning av en extern MP3-fil från den angivna URL:en. Om du skickar ett giltigt URLRequest-objekt till Sound-konstruktorn anropas funktionen Sound.load(). Du behöver bara anropa Sound.load() om du inte skickar ett giltigt URLRequest-objekt till Sound-konstruktorn eller om du skickar ett null-värde.

Om load() har anropats för ett Sound-objekt går det inte att senare läsa in en annan ljudfil till det Sound-objektet. Om du vill läsa in en annan ljudfil skapar du ett nytt Sound-objekt.

Överväg följande säkerhetsmodell när du använder den här metoden:

  • Det är inte tillåtet att anropa Sound.load() om den anropande filen finns i filsystemets lokala sandlåda och ljudet kommer från en sandlåda i ett nätverk.
  • Åtkomst från sandlådan lokal-tillförlitlig eller sandlådan lokal-med-nätverk kräver tillstånd från en webbplats i en URL-principfil.
  • Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.
  • Du kan förhindra att den här metoden används av en SWF-fil genom att ställa in parametern allowNetworking i object- och embed-taggarna på den HTML-sida där SWF-innehållet finns.

Om du i Flash Player 10 eller senare använder en multipart-innehållstyp (till exempel ”multipart/form-data”) som innehåller en överföring (vilket indikeras av en ”filename”-parameter i ett ”content-disposition”-huvud inuti POST), gäller de säkerhetsregler som används för överföringar också för POST-åtgärden.

  • POST-åtgärden måste utföras som ett svar på en användarinitierad åtgärd som exempelvis en musklickning eller en tangenttryckning.
  • Om POST-åtgärden är för korsdomän (POST-målet ligger inte på samma server som SWF-filen som skickar POST-begäran), måste målservern ha en URL-policyfil som tillåter korsdomänåtkomst.

För en multipart-innehållstyp måste också syntaxen vara giltig (enligt RFC2046-standarderna). Om syntaxen verkar vara ogiltig, gäller samma regler för POST-åtgärden som för överföringar.

I Adobe AIR begränsas inte innehåll i säkerhetssandlådan application (innehåll som installeras med AIR-programmet) av de här säkerhetsbegränsningarna.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

Parametrar

stream:URLRequest — En URL som pekar på en extern MP3-fil.
 
context:SoundLoaderContext (default = null) — Ett valfritt SoundLoader-kontextobjekt som kan definiera bufferttiden (det minsta antal millisekunder med MP3-data som ska lagras i Sound-objektets buffert) och ange huruvida programmet ska söka efter en korsdomänprincipfil före inläsningen av ljudet.


Utlöser
IOError — Inläsningen misslyckades på grund av ett nätverksfel.
 
SecurityError — Lokala otillförlitliga filer kanske inte kan kommunicera med Internet. Du kan undvika problemet genom att klassificera om filen som lokal med nätverkstjänst eller tillförlitlig.
 
SecurityError — Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.
 
IOError — Egenskapen digest för objektet stream är inte null. Du bör endast ange egenskapen digest för ett URLRequest-objekt när du anropar metoden URLLoader.load() när du läser in en SWZ-fil (en plattformskomponent för Adobe).

Exempel  ( Så här använder du exemplet )

I följande exempel visas inläsningsprocessen för en ljudfil.

I konstruktorn skapas ett URLRequest-objekt för att identifiera platsen för ljudfilen, som är en poddsändning från Adobe. Filen läses in i ett try...catch-block för att eventuella fel som kan uppstå i filinläsningen ska kunna hanteras. Om ett IO-fel skulle uppstå anropas även metoden errorHandler() och felmeddelandet skrivs i textfältet som är avsett för förloppsrapporten. När en inläsning pågår skickas en ProgressEvent.PROGRESS-händelse och metoden progressHandler() anropas. Här används ProgressEvent.PROGRESS-händelsen som en timer för att beräkna inläsningens förlopp.

Metoden progressHandler() delar bytesLoaded-värdet som skickas med ProgressEvent-objektet med bytesTotal-värdet för beräkna hur många procent av ljuddata som har lästs in. Sedan visas värdena i textfältet. (Observera att om filen är liten, chachad eller finns i en lokal katalog kanske förloppet går för fort för att märkas.)

package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.events.ProgressEvent;
    import flash.events.IOErrorEvent;
    
    public class Sound_loadExample extends Sprite {
        private var snd:Sound = new Sound();
        private var statusTextField:TextField  = new TextField();

        public function Sound_loadExample(){

            statusTextField.autoSize = TextFieldAutoSize.LEFT;
            var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
            
            try {
            snd.load(req);
            
            snd.play();
            }
            catch (err:Error) {
                trace(err.message);
            }
 
            snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
            snd.addEventListener(ProgressEvent.PROGRESS, progressHandler);
                     
            this.addChild(statusTextField);
        }
    
        private function progressHandler(event:ProgressEvent):void {
            var loadTime:Number = event.bytesLoaded / event.bytesTotal;
            var LoadPercent:uint = Math.round(100 * loadTime);
              
            statusTextField.text = "Sound file's size in bytes: " + event.bytesTotal + "\n" 
                                 + "Bytes being loaded: " + event.bytesLoaded + "\n" 
                                 + "Percentage of sound file that is loaded " + LoadPercent + "%.\n";
        }
 
        private function errorHandler(errorEvent:IOErrorEvent):void {
            statusTextField.text = "The sound could not be loaded: " + errorEvent.text;
        }
    }
}

loadCompressedDataFromByteArray

()metod 
public function loadCompressedDataFromByteArray(bytes:ByteArray, bytesLength:uint):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 3, Flash Player 11

läs in MP3-ljudinformation från ett ByteArray-objekt till ett Sound-objekt. Informationen kommer att läsas från den aktuella ByteArray-positionen och kommer att lämna ByteArray-positionen i slutet av den angivna bytelängden när allt är klart. Om MP3-ljudinformationen innehåller ID3-data, kommer ID3-händelser att skickas under detta funktionsanrop. Den här funktionen kommer att generera ett undantag om ByteArray-objektet inte innehåller tillräckligt med data.

Parametrar

bytes:ByteArray
 
bytesLength:uint

loadPCMFromByteArray

()metod 
public function loadPCMFromByteArray(bytes:ByteArray, samples:uint, format:String = "float", stereo:Boolean = true, sampleRate:Number = 44100.0):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 3, Flash Player 11

Läs in PCM 32-bitars flyttalsljudinformation för ett ByteArray-objekt till ett Sound-objekt. Informationen kommer att läsas från den aktuella ByteArray-positionen och lämna ByteArray-positionen i slutet av den angivna sampellängden fördelad på antingen en kanal eller två kanaler om stereoflaggan är inställd när allt är klart.

Från och med Flash Player 11.8 är mängden ljuddata som kan skickas till den här funktionen begränsad. För SWF-versioner från och med 21 genererar den här funktionen ett undantagsfel om mängden ljuddata som skickas till den är mer än 1 800 sekunder. Det betyder att samples/sampleRate bör vara mindre än eller lika med 1 800. För SWF-versioner tidigare än 21 uppstår ett tyst fel i körningen om mängden ljuddata är mer än 12 000 sekunder. Detta är endast för bakåtkompatibilitet.

Den här funktionen kommer att generera ett undantag om ByteArray-objektet inte innehåller tillräckligt med data.

Parametrar

bytes:ByteArray
 
samples:uint
 
format:String (default = "float")
 
stereo:Boolean (default = true)
 
sampleRate:Number (default = 44100.0)

play

()metod 
public function play(startTime:Number = 0, loops:int = 0, sndTransform:flash.media:SoundTransform = null):SoundChannel

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skapar ett nytt SoundChannel-objekt som ska spela upp ljudet. Den här metoden returnerar ett SoundChannel-objekt, vilket du får åtkomst när du vill stoppa ljudet och justera volymen. (Om du vill kontrollera volymen, panoreringen och balansen går du till SoundTransform-objektet som tilldelats ljudkanalen.)

Parametrar

startTime:Number (default = 0) — Den ursprungliga positionen (i millisekunder) som uppspelningen ska starta på.
 
loops:int (default = 0) — Anger hur många gånger ett ljud går tillbaka i en slinga till startTime-värdet innan uppspelningen stoppas av ljudkanalen.
 
sndTransform:flash.media:SoundTransform (default = null) — Det ursprungliga SoundTransform-objekt som är tilldelat ljudkanalen.

Returnerar
SoundChannel — Ett SoundChannel-objekt som du använder för att kontrollera ljudet. Den här metoden returnerar null om du inte har något ljudkort eller om du inte har några ljudkanaler kvar. Högsta antal ljudkort som finns tillgängliga samtidigt är 32.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel kan användaren använda en grafisk stapel för att välja startposition (starttid) i en inläst ljudfil.

Konstruktorn anropar metoden Sound.load() för att börja läsa in ljuddata. Sedan anropas metoden Sound.play(), som börjar spela upp ljudet så snart tillräckligt med data har lästs in. Metoden Sound.play() returnerar ett SoundChannel-objekt som kan användas för att styra ljuduppspelningen. I textfältet visas instruktionerna. För att det innehåll användaren vill börja spela upp vid säkert ska ha lästs in, skapas och visas Sprite-objektet bar efter att hela filen har lästs in. En Event.COMPLETE-händelse skickas när filen har lästs in, vilket aktiverar metoden completeHandler(). Metoden completeHandler() skapar sedan stapeln och lägger till den i visningslistan. (Ett Sprite-objekt används i stället för ett Shape-objekt för interaktivitetens skull.) När användaren klickar på stapeln anropas metoden clickHandler().

I metoden clickHandler() avgör x-koordinaten för användarens klick, event.localX, var användaren vill att filen ska börja spelas upp. Eftersom stapeln är 100 pixlar och börjar vid x-koordinaten 100 pixlar är det lätt att avgöra en positionens procentvärde. Eftersom filen har lästs in är ljudfilens length-egenskap lika med hela filens längd i millisekunder. Med hjälp av ljudfilens längd och positionen på linjen beräknas en startposition för ljudfilen. När ljuduppspelningen har stoppats, startar den om från den valda startpositionen, som skickas som startTime-parameter till metoden play().

 
package {
    import flash.display.Sprite;
    import flash.display.Graphics;
    import flash.events.MouseEvent;
    import flash.media.Sound;;
    import flash.net.URLRequest;
    import flash.media.SoundChannel;
    import flash.events.ProgressEvent;
    import flash.events.Event;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.events.IOErrorEvent;
    
    public class Sound_playExample1 extends Sprite {
        private var snd:Sound = new Sound();
        private var channel:SoundChannel = new SoundChannel();
        private var infoTextField:TextField = new TextField();
    
        public function Sound_playExample1() {

            var req:URLRequest = new URLRequest("MySound.mp3");
            
            infoTextField.autoSize = TextFieldAutoSize.LEFT;
            infoTextField.text = "Please wait for the file to be loaded.\n" 
                                + "Then select from the bar to decide where the file should start.";
            
            snd.load(req);               
            channel = snd.play();

            snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
            snd.addEventListener(Event.COMPLETE, completeHandler);


            this.addChild(infoTextField);
        }

        private function completeHandler(event:Event):void {                
            infoTextField.text = "File is ready.";

            var bar:Sprite = new Sprite();

            bar.graphics.lineStyle(5, 0xFF0000);
            bar.graphics.moveTo(100, 100);
            bar.graphics.lineTo(200, 100);

            bar.addEventListener(MouseEvent.CLICK, clickHandler);

            this.addChild(bar);
        }
    
        private function clickHandler(event:MouseEvent):void {
            
                var position:uint = event.localX;
                var percent:uint = Math.round(position) - 100;   
                var cue:uint = (percent / 100) * snd.length;

                channel.stop();
                channel = snd.play(cue);    
        }

        private function errorHandler(errorEvent:IOErrorEvent):void {
            infoTextField.text = "The sound could not be loaded: " + errorEvent.text;
        }
    }
}

I följande exempel spelas ljudet upp en eller två gånger beroende på om användaren klickar en gång eller dubbelklickar på en knapp.

I konstruktorn läses ljudet in och det enkla rektangulära Sprite-objektet button skapas. (Ett Sprite-objekt används i stället för ett Shape-objekt för interaktivitetens skull.) Här antas ljudfilen finnas i samma katalog som SWF-filen. (Det finns ingen felhantering för det här exemplet.)

Två händelseavlyssnare skapas för att reagera på enstaka musklick och dubbelklick. Om användaren klickar en gång anropas metoden clickHandler() och ljudet spelas upp. Om användaren dubbelklickar på knappen anropas metoden doubleClickHandler() och ljudfilen spelas upp två gånger. Det andra argumentet i metoden play() ställs in på 1, vilket innebär att ljudet kommer att gå tillbaka till starttiden en gång för att spelas upp igen. Starttiden (det första argumentet) ställs in på 0, vilket innebär att filen ska spelas upp från början.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.media.Sound;
    import flash.net.URLRequest;

    public class Sound_playExample2 extends Sprite {
        private var button:Sprite = new Sprite(); 
        private var snd:Sound = new Sound();
            
        public function Sound_playExample2() {

            var req:URLRequest = new URLRequest("click.mp3");
            snd.load(req);               
     
            button.graphics.beginFill(0x00FF00);
            button.graphics.drawRect(10, 10, 50, 30);
            button.graphics.endFill();
     
            button.addEventListener(MouseEvent.CLICK, clickHandler);
            button.addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler);
     
            this.addChild(button);
        }

        private function clickHandler(event:MouseEvent):void {
            snd.play();            
        }

        private function doubleClickHandler(event:MouseEvent):void {
            snd.play(0, 2);        
        }
    }
}

I följande exempel visas inläsnings- och uppspelningsprocessen för en ljudfil.

I konstruktorn läses filen in i ett try...catch-block för att eventuella fel som kan uppstå i filinläsningen ska kunna hanteras. En avlyssnare läggs till i ljudobjektet för att svara på en IOErrorEvent-händelse genom att anropa metoden errorHandler(). En annan avlyssnare läggs till för huvudprogrammet. Den ska svara på en Event.ENTER_FRAME-händelse, vilket används som tidsmekanism för att visa uppspelningsförloppet. Slutligen läggs en tredje avlyssnare till för ljudkanalen. Den ska svara på en Event.SOUND_COMPLETE-händelse (när hela ljudet har spelats upp) genom att anropa metoden soundCompleteHandler(). Metoden soundCompleteHandler() tar också bort händelseavlyssnaren för händelsen Event.ENTER_FRAME.

Metoden enterFrameHandler() delar bytesLoaded-värdet som skickas med ProgressEvent-objektet med bytesTotal-värdet för beräkna hur många procent av ljuddata som har lästs in. Procentandelen ljuddata som spelas upp kan beräknas genom att värdet för ljudkanalens position-egenskap delas med ljudfilens totala längd. Men om ljudet inte har lästs in helt visar ljudobjektets length-egenskap bara den del av ljudfilen som har lästs in. En uppskattning av hela ljudfilens längd beräknas genom att värdet för det aktuella ljudobjektets length delas med värdet för bytesLoaded-egenskapen delat med egenskapen bytesTotal.

Observera att om filen är liten, chachad eller finns i en lokal katalog kanske inläsningsförloppet går för fort för att märkas. Fördröjningen från att ljudfilen börjar läsas in till att inlästa data börjar spelas upp avgörs av värdet för egenskapen SoundLoaderContext.buffertime. Standardvärdet är 1000 millisekunder och kan ändras.

package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.events.Event;
    import flash.events.IOErrorEvent;
    
    public class Sound_playExample3 extends Sprite {
        private var snd:Sound = new Sound();
        private var channel:SoundChannel;
        private var statusTextField:TextField  = new TextField();

        public function Sound_playExample3(){

            statusTextField.autoSize = TextFieldAutoSize.LEFT;

           var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
            
            try {
                snd.load(req);
            
                channel = snd.play();
            }
            catch (err:Error) {
                trace(err.message);
            }
                    
            snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
            addEventListener(Event.ENTER_FRAME, enterFrameHandler);
            channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler);
                    
            this.addChild(statusTextField);
        }
    
        private function enterFrameHandler(event:Event):void {    
            var loadTime:Number = snd.bytesLoaded / snd.bytesTotal;
            var loadPercent:uint = Math.round(100 * loadTime);
            var estimatedLength:int = Math.ceil(snd.length / (loadTime));
            var playbackPercent:uint = Math.round(100 * (channel.position / estimatedLength));
      
            statusTextField.text = "Sound file's size is " + snd.bytesTotal + " bytes.\n" 
                                   + "Bytes being loaded: " + snd.bytesLoaded + "\n" 
                                   + "Percentage of sound file that is loaded " + loadPercent + "%.\n"
                                   + "Sound playback is " + playbackPercent + "% complete.";     
        }
 
        private function errorHandler(errorEvent:IOErrorEvent):void {
            statusTextField.text = "The sound could not be loaded: " + errorEvent.text;
        }

        private function soundCompleteHandler(event:Event):void {
            statusTextField.text = "The sound has finished playing.";
            removeEventListener(Event.ENTER_FRAME, enterFrameHandler);
        }
    }
}
Händelsedetaljer

complete

Händelse
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.COMPLETE

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas när alla data är inlästa.

Event.COMPLETE-konstanten definierar värdet på type-egenskapen i ett complete-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetDet nätverksobjekt som har lästs in.

Relaterade API-element

id3

Händelse  
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.ID3

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas av ett Sound-objekt när ID3-data finns tillgängligt för ett MP3-ljud.

Event.ID3-konstanten definierar värdet på type-egenskapen i ett id3-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetSound-objektet som läser in den MP3 som ID3-data nu är tillgänglig för. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen.

Relaterade API-element

ioError

Händelse  
Typ av händelseobjekt: flash.events.IOErrorEvent
egenskap IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas om ett in- eller utdatafel orsakar en misslyckad inläsningsåtgärd.

Definierar värdet för ett ioError-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
errorIDEtt referensnummer som associeras med det specifika felet (enbart AIR).
targetObjektet är med om ett in-/utdatafel.
textText som visas som felmeddelande.

Relaterade API-element

open

Händelse  
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.OPEN

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas när en inläsning initieras.

Event.OPEN-konstanten definierar värdet på type-egenskapen i ett open-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetDet nätverksobjekt som har öppnat en anslutning.

Relaterade API-element

progress

Händelse  
Typ av händelseobjekt: flash.events.ProgressEvent
egenskap ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas när data tas emot som ett inläsningsförlopp.

Definierar värdet för ett progress-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
bytesLoadedAntalet objekt eller byte som har lästs in när avlyssnaren bearbetar händelsen.
bytesTotalDet totala antalet objekt eller byte som kommer att ha lästs in om inläsningen lyckas.
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetObjektet rapporterar förlopp.

Relaterade API-element

sampleData

Händelse  
Typ av händelseobjekt: flash.events.SampleDataEvent
egenskap SampleDataEvent.type = flash.events.SampleDataEvent.SAMPLE_DATA

Språkversion: ActionScript 3.0
Körningsmiljöversioner: Flash Player 10, AIR 1.5

Skickas när miljön begär nya ljuddata.

Definierar värdet för ett SampleDataEvent-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
positionPlatsen som ljuddata kommer ifrån.

Exempel  ( Så här använder du exemplet )

Följande exempel spelar upp en enkel sinusvåg.
var mySound:Sound = new Sound();
function sineWaveGenerator(event:SampleDataEvent):void {
    for ( var c:int=0; c<8192; c++ ) {
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
    }
}

mySound.addEventListener(SampleDataEvent.SAMPLE_DATA,sineWaveGenerator);
mySound.play();

Relaterade API-element

SoundExample.as

I följande exempel visas information om ljudhändelser som inträffar när en MP3-fil öppnas och spelas upp. Om du vill köra det här exemplet placerar du en fil med namnet MySound.mp3 i samma katalog som din SWF-fil.
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.net.URLRequest;

    public class SoundExample extends Sprite {
        private var url:String = "MySound.mp3";
        private var song:SoundChannel;

        public function SoundExample() {
            var request:URLRequest = new URLRequest(url);
            var soundFactory:Sound = new Sound();
            soundFactory.addEventListener(Event.COMPLETE, completeHandler);
            soundFactory.addEventListener(Event.ID3, id3Handler);
            soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            soundFactory.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            soundFactory.load(request);
            song = soundFactory.play();
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function id3Handler(event:Event):void {
            trace("id3Handler: " + event);
        }

        private function ioErrorHandler(event:Event):void {
            trace("ioErrorHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler: " + event);
        }
    }
}




[ X ]Varför på engelska?
Innehåll i Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen är på engelska

Det är inte alla delar av Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen som översätts till alla språk. Om ett språkelement inte översätts visas det på engelska. Klassen ga.controls.HelpBox översätts till exempel inte till något språk. I den svenska versionen av referenshandboken visas därför klassen ga.controls.HelpBox på engelska.