Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: AIR 30.0 ve öncesi, Flash Player 30.0 ve öncesi, Flash Lite 4
Flex 4.6 ve öncesi, Flash Pro CS6 ve öncesi
Filtreleri Gizle
flash.media 

Sound  - AS3

Paketlerx

Üst Düzey
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

Dil Öğeleri

Global Sabitler
Global İşlevler
Operatörler
İfadeler, Anahtar Kelimeler ve Direktifler
Özel Türler

Ekler

Yenilikler
Derleyici Hataları
Derleyici Uyarıları
Çalışma Zamanı Hataları
ActionScript 3'e Geçiş Yapma
Desteklenen Karakter Kümeleri
Yalnızca MXML Etiketleri
Motion XML Öğeleri
Timed Text Etiketleri
Onaylanmamış öğelerin listesi
Erişilebilirlik Uygulaması Sabitleri
ActionScript Örnekleri Nasıl Kullanılır?
Yasal uyarılar
Paketflash.media
Sınıfpublic class Sound
Miras AlmaSound Inheritance EventDispatcher Inheritance Object
Alt Sınıflar SoundAsset

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Sound sınıfı bir uygulamada sesle çalışmanıza izin verir. Sound sınıfı bir Sound nesnesi oluşturmanıza, harici bir MP3 dosyasını söz konusu nesneye yüklemenize ve oynatmanıza, ses akışını kapatmanıza ve akıştaki bayt sayısı ve ID3 meta verileriyle ilgili bilgiler gibi sesle ilgili verilere erişmenize olanak sağlar. Ses, ses kaynağı — sese yönelik SoundChannel veya Microphone nesnesi — yoluyla ve bilgisayar hoparlörlerine giden ses çıkışını kontrol eden SoundTransform sınıfındaki özellikler yoluyla daha ayrıntılı şekilde kontrol edilebilir.

Flash Player 10 ve daha sonraki sürümleri ile AIR 1.5 ve daha sonraki sürümlerinde, aynı zamanda dinamik olarak oluşturulan sesle birlikte çalışmak için de bu sınıfı kullanabilirsiniz. Bu durumda, Sound nesnesi ses verilerini istemek için sampleData olay işleyicisine atadığınız işlevi kullanır. Ses, ses verileriyle doldurduğunuz bir ByteArray nesnesinden alındığı şekliyle oynatılır. Bir Sound nesnesinden ses verilerini ayıklamak için Sound.extract() öğesini kullanabilirsiniz, bu işlemden sonra verileri oynatma için akışa yazmadan önce işleyebilirsiniz.

SWF dosyasına gömülü sesleri kontrol etmek için, SoundMixer sınıfındaki özellikleri kullanın.

Not: ActionScript 3.0 Sound API, ActionScript 2.0'dan farklıdır. ActionScript 3.0'da, ses nesnelerini alıp özelliklerini kontrol etmek için bu nesneleri hiyerarşi içinde düzenleyemezsiniz.

Bu sınıfı kullanırken aşağıdaki güvenlik modelini dikkate alın.

  • Çağıran dosyası bir ağ sanal alanı içindeyse ve yüklenecek ses dosyası yerelse sesin yüklenmesine ve çalınmasına izin verilmez.
  • Varsayılan olarak, çağıran dosyası yerelse ve uzak bir sesi yükleyip çalmayı denerse sesin yüklenmesine ve çalınmasına izin verilmez. Kullanıcının bu erişim türüne izin vermek için açıkça izin vermesi gerekir.
  • Sesle ilgili belirli işlemler sınırlanmıştır. Etki alanları arası ilke dosyası uygulamadığınız sürece, farklı bir etki alanındaki bir dosyası yüklenen bir sesteki verilere erişemez. Bu kısıtlamanın kapsamındaki sesle ilgili API'ler Sound.id3, SoundMixer.computeSpectrum(), SoundMixer.bufferTime ve SoundTransform sınıfıdır.

Ancak Adobe AIR'de, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Örnekleri görüntüle

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
  bytesLoaded : uint
[salt okunur] Bu ses nesnesinde geçerli olarak kullanılabilir bayt sayısını döndürür.
Sound
  bytesTotal : int
[salt okunur] Bu ses nesnesindeki toplam bayt sayısını döndürür.
Sound
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
  id3 : ID3Info
[salt okunur] Bir MP3 dosyasının parçası olan meta veriye erişim sağlar.
Sound
  isBuffering : Boolean
[salt okunur] Harici MP3 dosyalarının arabelleğe alma durumunu döndürür.
Sound
  isURLInaccessible : Boolean
[salt okunur] Sound.url özelliğinin kırpılıp kırpılmadığını gösterir.
Sound
  length : Number
[salt okunur] Geçerli sesin milisaniye olarak uzunluğu.
Sound
  url : String
[salt okunur] Bu sesin yüklendiği URL.
Sound
Genel Yöntemler
 YöntemTanımlayan:
  
Sound(stream:URLRequest = null, context:SoundLoaderContext = null)
Yeni Sound nesnesi oluşturur.
Sound
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.
EventDispatcher
  
Akışı kapatır, indirilmekte olan verileri keser.
Sound
 Inherited
Olay akışına bir olay gönderir.
EventDispatcher
  
extract(target:ByteArray, length:Number, startPosition:Number = -1):Number
Bir Sound nesnesinden ham ses verisi çıkarır.
Sound
 Inherited
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.
EventDispatcher
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
  
load(stream:URLRequest, context:SoundLoaderContext = null):void
Harici bir MP3 dosyasının belirtilen URL'den yüklenmesini başlatır.
Sound
  
bir ByteArray nesnesinden Sound nesnesine MP3 ses verisi yükler.
Sound
  
loadPCMFromByteArray(bytes:ByteArray, samples:uint, format:String = "float", stereo:Boolean = true, sampleRate:Number = 44100.0):void
Bir ByteArray nesnesinden Sound nesnesine PCM 32 bit kayan nokta ses verisi yükler.
Sound
  
play(startTime:Number = 0, loops:int = 0, sndTransform:flash.media:SoundTransform = null):SoundChannel
Sesi çalmak için yeni bir SoundChannel nesnesi üretir.
Sound
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher nesnesinden bir dinleyiciyi kaldırır.
EventDispatcher
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
 Inherited
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.
Object
 Inherited
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Object
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
 Inherited
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.
EventDispatcher
Olaylar
 Olay Özet Tanımlayan:
 Inherited[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.EventDispatcher
  Veriler başarılı şekilde yüklendiğinde gönderilir.Sound
 Inherited[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.EventDispatcher
  Bir MP3 ses dosyasında ID3 dosyası bulunduğunda bir Sound nesnesi tarafından gönderilir.Sound
  Bir yükleme işleminin başarısız olmasına neden olan bir girdi/çıktı hatası ortaya çıktığında gönderilir.Sound
  Bir yükleme işlemi başladığında gönderilir.Sound
  İndirme işleminin ilerlemesi sırasında veri alındığında gönderilir.Sound
  Çalışma zamanı yeni ses verileri istediğinde gönderilir.Sound
Özellik Ayrıntısı

bytesLoaded

özellik
bytesLoaded:uint  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bu ses nesnesinde geçerli olarak kullanılabilir bayt sayısını döndürür. Bu özellik genellikle harici olarak yüklenen dosyalar için kullanışlıdır.



Uygulama
    public function get bytesLoaded():uint

bytesTotal

özellik 
bytesTotal:int  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bu ses nesnesindeki toplam bayt sayısını döndürür.



Uygulama
    public function get bytesTotal():int

id3

özellik 
id3:ID3Info  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir MP3 dosyasının parçası olan meta veriye erişim sağlar.

MP3 ses dosyaları, dosya hakkında meta veriler sağlayan ID3 etiketlerini içerebilir. Sound.load() yöntemini kullanarak yüklediğiniz MP3 sesi, ID3 etiketleri içerir, bu özellikleri sorgulayabilirsiniz. Yalnızca UTF-8 karakter kümesini kullanan ID3 etiketleri desteklenir.

Flash Player 9 ve daha sonraki sürümleri ile AIR destek ID3 2.0 etiketlerini, özellikle 2.3 ve 2.4'ü destekler. Aşağıdaki tablolar, standart ID3 2.0 etiketlerini ve etiketlerin temsil ettiği içerik türünü listeler. Sound.id3 özelliği, my_sound.id3.COMM, my_sound.id3.TIME, vb. biçimiyle bu etiketlere erişim sağlar. Birinci tablo, ID3 2.0 özellik adıyla veya ActionScript özellik adıyla erişilebilen etiketleri açıklar. İkinci tablo, desteklenen ancak ActionScript'te önceden tanımlanmış özelliklere sahip olmayan ID3 etiketlerini açıklar.

ID3 2.0 etiketiKarşılık gelen Sound sınıfı özelliği
COMMSound.id3.comment
TALBSound.id3.album
TCONSound.id3.genre
TIT2Sound.id3.songName
TPE1Sound.id3.artist
TRCKSound.id3.track
TYERSound.id3.year

Aşağıdaki tablo, Sound sınıfında desteklenen, ancak önceden tanımlanmış özelliklere sahip olmayan ID3 etiketlerini açıklar. mySound.id3.TFLT, mySound.id3.TIME, vb. öğelerini çağırarak bunlara erişebilirsiniz. NOT: Bu etiketlerin hiç biri Flash Lite 4'te desteklenmez.

ÖzellikAçıklama
TFLTDosya türü
TIMESüre
TIT1İçerik grubu açıklaması
TIT2Başlık/şarkı adı/içerik açıklaması
TIT3Altyazı/açıklama geliştirme
TKEYBaşlangıç tuşu
TLANDiller
TLENUzunluk
TMEDMedya türü
TOALOrijinal albüm/film/gösteri başlığı
TOFNOrijinal dosya adı
TOLYOrijinal söz/metin yazarları
TOPEOrijinal sanatçılar/icracılar
TORYOrijinal yayınlanma tarihi
TOWNDosya/lisans sahibi
TPE1Baş icracı/solistler
TPE2Grup/orkestra/topluluk
TPE3Orkestra şefi/icracı geliştirmesi
TPE4Yorumlayan, remiks yapan veya değiştiren
TPOSKümenin parçası
TPUBYayıncı
TRCKParça sayısı/kümedeki konumu
TRDAKayıt tarihleri
TRSNİnternet radyo istasyonu adı
TRSOİnternet radyo istasyonu sahibi
TSIZBoyut
TSRCISRC (uluslararası standart kayıt kodu)
TSSEKodlamada kullanılan yazılım/donanım ve ayarlar
TYERYıl
WXXXURL bağı karesi

Bu yöntemi kullanırken Flash Player güvenlik modelini göz önünde bulundurun:

  • Ses dosyasıyla aynı sanal güvenlik alanındaki SWF dosyaları için bir Sound nesnesinin id3 özelliğine her zaman izin verilir. Diğer sanal alanlardaki dosyalar için güvenlik kontrolleri vardır.
  • Sesi yüklediğinizde, Sound sınıfının load() yöntemini kullanarak, bir SoundLoaderContext nesnesi olan bir context parametresini belirtebilirsiniz. SoundLoaderContext nesnesinin checkPolicyFile özelliğini true değerine ayarlarsanız, Flash Player, sesin yüklendiği sunucuda URL ilke dosyasını kontrol eder. İlke dosyası varsa ve yüklenen SWF dosyasının etki alanından erişime izin veriyorsa, bu durumda dosyanın Sound nesnesinin id3 özelliğine erişmesine izin verilir; aksi takdirde izin verilmez.

Ancak Adobe AIR'de, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.



Uygulama
    public function get id3():ID3Info

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )
Şu örnek, bir ses dosyasındaki ID3 bilgilerini okur ve bu bilgileri metin alanında görüntüler.

Yapıcıda, ses dosyası yüklenir ancak oynatılacak şekilde ayarlanmaz. Burada, dosyanın SWF dizininde olduğu varsayılır. Yüklenen ses dosyasının ID3 etiketlerini okumak için sistemin izninin olması gerekir. Dosyada ID3 bilgileri varsa ve programın bunları okumasına izin veriliyorsa, bir Event.ID3 olayı tetiklenir ve ses dosyasının id3 özelliği doldurulur. id3 özelliği, tüm ID3 bilgilerini içeren bir ID3Info nesnesine sahiptir.

id3Handler() yönteminde, dosyanın ID3 etiketleri bir ID3Info sınıfı nesnesi olan id3 içinde saklanır. ID3 etiketleri listesini görüntülemek için bir metin alanı başlatılır. for döngüsü tüm ID3 2.0 etiketleri boyunca yinelenir ve metin alanının içeriklerine adı ve değeri ekler. ID3 bilgileri (ID3Info) özellikleri kullanılarak sanatçı, şarkı adı ve albüm de eklenir. ActionScript 3.0, Flash Player 9 ve sonrası, ID3 2.0 etiketlerini, özellikle de 2.3 ve 2.4'ü destekler. for döngüsündeki gibi özellikler boyunca yineleme işlemi yaparsanız, yalnızca ID3 2.0 etiketleri görüntülenir. Ancak, önceki sürümlerdeki veriler ayrıca şarkının id3 özelliğinde saklanır ve ID3 info sınıfı özellikleri kullanılarak erişilebilir. ID3 1.0 etiketleri dosyanın sonunda bulunurken, ID3 2.0 etiketleri dosyanın başında bulunur. (Bazen dosyalarda önceki ve sonraki sürüm etiketleri aynı yerde bulunabilir.) Bir dosya, dosyanın başında ve sonunda hem sürüm 1.0 hem de 2.0 etiketleriyle kodlanmışsa, id3Handler() yöntemi iki defa çağrılır. İlk olarak 2.0 sürümünü ve sonra 1.0 sürümünü okur. Yalnızca ID3 1.0 etiketi mevcutsa, bu durumda bilgiye id3.songname gibi ID3 info özellikleri yoluyla erişilebilir. ID3 2.0 için, id3.TITS özelliği yeni etiketi (TITS) kullanarak şarkı adını alır.

Bu örnek için herhangi bir hata işlemenin yazılmadığını ve ID3 içeriği uzunsa, sonucun görüntülenebilir alanın dışına çıkabileceğini unutmayın.

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

özellik 
isBuffering:Boolean  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Harici MP3 dosyalarının arabelleğe alma durumunu döndürür. Değer true olursa, nesne daha fazla veri beklerken, oynatma işlemi askıya alınır.



Uygulama
    public function get isBuffering():Boolean

isURLInaccessible

özellik 
isURLInaccessible:Boolean  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 10.1, AIR 2

Sound.url özelliğinin kırpılıp kırpılmadığını gösterir. isURLInaccessible değeri true olduğunda, Sound.url değeri yalnızca sesin yüklendiği son URl'nin etki alanıdır. Örneğin, ses http://www.adobe.com/assets/hello.mp3 adresinden yüklendiyse özellik kırpılır ve Sound.url özelliği http://www.adobe.com değerine sahip olur. isURLInaccessible değeri yalnızca aşağıdakilerin tümü true olduğunda true olur:

  • Ses dosyası yüklenirken bir HTTP yeniden yönlendirmesi gerçekleşmiştir.
  • Sound.load() öğesini çağıran SWF dosyası ses dosyasının son URL'sinden farklı bir etki alanındandır.
  • Sound.load() öğesini çağıran SWF dosyasının ses dosyasına erişmeye izni yoktur. Ses dosyasına erişmek için verilen izin, Sound.id3 özelliği için verilenle aynı şekilde verilir: bir ilke dosyası oluşturun ve SoundLoaderContext.checkPolicyFile özelliğini kullanın.

Not: isURLInaccessible özelliği Adobe Flash Player 10.1 ve AIR 2 için eklenmiştir ancak Flash çalışma zamanı desteklediğinde bütün sürümlerin SWF dosyaları için ulaşılabilir kılınmıştır. Bundan dolayı "sıkı mod"da geliştirme araçlarından bazılarını kullanmak derleme hatasına sebep olur. Hata üzerinde çalışmak için mySound["isURLInaccessible"] adlı dolaylı sözdizimini kullanın veya sıkı modunu devre dışı bırakın. Flash Professional CS5 veya Flex SDK 4.1 kullanıyorsanız, bu API'yi Flash Player 10.1 ve AIR 2'den önce yayımlanan çalışma zamanları için kullanabilir ve derleyebilirsiniz.

AIR'deki uygulama içeriği için, bu özelliğin değeri her zaman false değeridir.



Uygulama
    public function get isURLInaccessible():Boolean

İlgili API Öğeleri

length

özellik 
length:Number  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Geçerli sesin milisaniye olarak uzunluğu.



Uygulama
    public function get length():Number

url

özellik 
url:String  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bu sesin yüklendiği URL. Bu özellik yalnızca Sound.load() yöntemi kullanılarak yüklenen Sound nesnelerine uygulanabilir. Bir SWF dosyası kütüphanesinden gelen bir ses varlığıyla ilişkili Sound nesneleri için url özelliğinin değeri null olur.

Son URL henüz bilinmediğinden, ilk defa Sound.load() çağırdığınızda url özelliğinin ilk değeri null olur. Sound nesnesinden bir open olayı gönderilir gönderilmez url özelliği null olmayan bir değere sahip olacaktır.

url özelliği bir ses yüklenen son, mutlak URL'yi içerir. url değeri genellikle, Sound.load() öğesinin stream parametresine iletilen değerle aynıdır. Ancak, Sound.load() öğesine göreceli bir URL ilettiyseniz, url özelliğinin değeri mutlak URL'yi temsil eder. Ayrıca, orijinal URL isteği bir HTTP sunucusu tarafından yeniden yönlendirilirse, url özelliğinin değeri, ses dosyasının gerçekten indirildiği son URL'yi yansıtır. Böyle bir son mutlak URL'nin bildirilmesi, LoaderInfo.url davranışına eşdeğerdir.

Bazı durumlarda url özelliğinin değeri kırpılır. Ayrıntılar için isURLInaccessible özelliğine başvurun.



Uygulama
    public function get url():String

İlgili API Öğeleri

Yapıcı Ayrıntı

Sound

()Yapıcı
public function Sound(stream:URLRequest = null, context:SoundLoaderContext = null)

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Yeni Sound nesnesi oluşturur. Sound yapıcısına geçerli bir URLRequest nesnesi iletirseniz, yapıcı Sound nesnesi için otomatik olarak load() işlevini çağırır. Sound yapıcısına geçerli bir URLRequest iletmezseniz, Sound nesnesi için load() işlevini sizin çağırmanız gerekir, yoksa akış yüklenmez.

load() bir Sound nesnesinin üzerine bir kez çağrıldığında, söz konusu Sound nesnesine daha sonra farklı bir ses dosyası yükleyemezsiniz. Farklı bir ses dosyası yüklemek için yeni bir Sound nesnesi oluşturun.

Flash Player 10 ve daha sonraki sürümleri ile AIR 1.5 ve daha sonraki sürümlerinde, Sound nesnesine dinamik olarak ses yüklemek için load() öğesini kullanmak yerine, sampleData olay işleyicisini kullanabilirsiniz.

Parametreler
stream:URLRequest (default = null) — Harici bir MP3 dosyasına işaret eden URL.
 
context:SoundLoaderContext (default = null) — Arabelleğe alma süresini (MP3 verilerinin Sound nesnesinin arabelleğinde tutulacağı minimum milisaniye sayısını) tanımlayabilen ve uygulamanın sesi yüklemeden önce etki alanları arası ilke dosyasını kontrol etmesi gerekip gerekmediğini belirleyebilen isteğe bağlı bir SoundLoader bağlam nesnesi.
Yöntem Ayrıntısı

close

()yöntem
public function close():void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Akışı kapatır, indirilmekte olan verileri keser. close() yöntemi çağrıldıktan sonra akıştan hiçbir veri okunamayabilir.


Atar
IOError — Akış kapatılamadı veya akış açık değildi.

Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnekte, kullanıcı Durdur düğmesini tıklattığında, Sound.close() yöntemi çağrılır ve ses akışı durur.

Yapıcıda, Başlat ve Durdur düğmeleri için bir metin alanı oluşturulur. Kullanıcı metin alanını tıklattığında, clickHandler() yöntemi çağrılır. Ses dosyasının başlangıcını ve bitişini işler. Ağ bağlantısına veya kullanıcının Durdur düğmesini tıklattığı zamana bağlı olarak, dosyanın büyük bölümü zaten yüklenmiş olabilir ve ses dosyasının çalmayı durdurması biraz zaman alabilir. Akış kapatılırken ortaya çıkabilecek herhangi bir IO hatasını yakalamak için bir try...catch bloğu kullanılır. Örneğin, ses yerel dizinden yüklenirse ve akışı yapılmazsa, hata 2029 yakalanır: “Bu URLStream nesnesi, açık bir akışa sahip değildir.“

 
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

()yöntem 
public function extract(target:ByteArray, length:Number, startPosition:Number = -1):Number

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 10, AIR 1.5

Bir Sound nesnesinden ham ses verisi çıkarır.

Bu yöntem, farklı bir Sound nesnesi için sampleData olayına atadığınız bir işlevi kullanarak dinamik olarak oluşturulan sesle çalışırken kullanılmak üzere tasarlanmıştır. Başka bir deyişle, bir Sound nesnesinden ses verilerini ayıklamak için bu yöntemi kullanabilirsiniz. Daha sonra dinamik sesi akışa almak için başka bir Sound nesnesinin kullandığı bayt dizisine verileri yazabilirsiniz.

Ses verileri, bayt dizisinin geçerli konumundan başlayan hedef bayt dizisine yerleştirilir. Ses verileri her zaman 44100 Hz Stereo olarak kullanıma sunulur. Örnek tür, ByteArray.readFloat() kullanılarak bir Number öğesine dönüştürülebilen 32-bit kayar nokta değeridir.

Parametreler

target:ByteArray — İçinde ayıklanmış ses örneklerinin bulunduğu ByteArray nesnesi.
 
length:Number — Ayıklanacak ses örneklerinin sayısı. Bir örnek, hem sol hem de sağ kanalı içeren — yani, iki 32 bit kayar nokta değeri.
 
startPosition:Number (default = -1) — Ayıklamanın başladığı örnek. Bir değer belirtmezseniz, Sound.extract() öğesine yapılan ilk çağrı sesin başlangıcında başlar; bir startPosition değeri olmayan sonraki çağrılar dosya içinde sırayla ilerler.

Döndürür
Numbertarget parametresinde belirtilen ByteArray öğesine yazılan örnek sayısı.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnek, ses verilerine erişmek için bir mp3 dosyasını yükler ve Sound sınıfının extract() yöntemini kullanır.

sourceSnd Sound nesnesine mp3 verileri yüklenir. Uygulama mp3 verilerini yüklediğinde, loaded() (sourceSnd nesnesinin complete olayı için olay işleyicisi) işlevini çağırır. Değiştirilen sesi çalmak için, ikinci bir Sound nesnesi olan outputSound kullanılır. outputSound nesnesi bir sampleData olay dinleyicisine sahiptir; bu nedenle nesnenin play() yöntemini çağırdığınızda, nesne düzenli olarak sampleData olaylarını gönderir. upOctave() yöntemi, kaynak ses verisini esas alarak değiştirilen ses verilerinin bayt dizisini döndürür. Kaynak verideki diğer ses örneklerinin her birini atlayarak bir oktav yüksek ses döndürür. sampleData olayının olay işleyicisi, döndürülen bayt dizisini outputSound nesnesinin data özelliğine yazar. data bayt dizisi, outputSound nesnesinin çıktı ses verisine eklenir.

Bu örneği test etmek için, SWF dosyasıyla aynı dizine bir test.mp3 dosyası ekleyin.

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

()yöntem 
public function load(stream:URLRequest, context:SoundLoaderContext = null):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Harici bir MP3 dosyasının belirtilen URL'den yüklenmesini başlatır. Sound yapıcısına geçerli bir URLRequest nesnesi sağlarsanız, yapıcı sizin için Sound.load() öğesini çağırır. Sound.load() öğesini, yalnızca Sound yapıcısına geçerli bir URLRequest nesnesi iletmediğiniz veya bir null değeri ilettiğiniz zaman kendiniz çağırmanız gerekir.

load() bir Sound nesnesinin üzerine bir kez çağrıldığında, söz konusu Sound nesnesine daha sonra farklı bir ses dosyası yükleyemezsiniz. Farklı bir ses dosyası yüklemek için yeni bir Sound nesnesi oluşturun.

Bu yöntemi kullanırken, aşağıdaki güvenlik modelini göz önünde bulundurun:

  • Çağıran dosyasının dosya sistemine sahip yerel sanal alanda olması ve sesin bir ağ sanal alanında olması durumunda Sound.load() çağrılmasına izin verilmez.
  • Güvenilen yerel veya ağa sahip yerel sanal alandan erişim, bir URL ilke dosyası üzerinden web sitesi erişimi gerektirir.
  • Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.
  • SWF içeriğini barındıran HTML sayfasındaki object ve embed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.

Flash Player 10 ve sonrasında, yükleme (POST gövdesi içinde "content-disposition" başlığında "filename" parametresiyle belirtilir) içeren çok bölümlü bir Content-Type (örneğin, "multipart/form-data") kullanırsanız, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabidir:

  • Fare tıklatma veya tuş basışı gibi kullanıcı tarafından başlatılan bir eyleme yanıt olarak POST işleminin gerçekleştirilmesi gerekir.
  • POST işlemi etki alanları arasıysa (POST hedefi, POST isteğini gönderen SWF dosyasıyla aynı sunucuda değilse), hedef sunucunun etki alanları arası erişime izin veren bir URL ilke dosyası sağlaması gerekir.

Ayrıca çok bölümlü herhangi bir Content-Type için sözdiziminin geçerli olması gerekir (RFC2046 standartlarına göre). Sözdizimi geçersiz görünüyorsa, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabi olur.

Adobe AIR'da, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

stream:URLRequest — Harici bir MP3 dosyasına işaret eden bir URL.
 
context:SoundLoaderContext (default = null) — Arabelleğe alma süresini (MP3 verilerinin Sound nesnesinin arabelleğinde tutulacağı minimum milisaniye sayısını) tanımlayabilen ve uygulamanın sesi yüklemeden önce etki alanları arası ilke dosyasını kontrol etmesi gerekip gerekmediğini belirleyebilen isteğe bağlı bir SoundLoader bağlam nesnesi.


Atar
IOError — Bir ağ hatası yüklemenin başarısız olmasına neden oldu.
 
SecurityError — Güvenilmeyen yerel dosyalar İnternet ile iletişim kuramayabilir. Bu dosyayı ağa sahip yerel veya güvenilir olarak yeniden sınıflandırarak bu durumu ortadan kaldırabilirsiniz.
 
SecurityError — Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.
 
IOError stream nesnesinin digest özelliği null değildir. SWZ dosyası (bir Adobe platformu bileşeni) yüklenirken URLLoader.load() yöntemi çağrıldığında yalnızca URLRequest nesnesinin digest özelliğini ayarlamalısınız.

Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnek, bir ses dosyasının yüklenme ilerleyişini göstermektedir.

Bir Adobe podcast'i olan ses dosyasının konumunu tanımlamak için yapıcıda bir URLRequest nesnesi oluşturulur. Dosya yüklenirken ortaya çıkabilecek herhangi bir hatanın yakalanması için, dosya bir try...catch bloğuna yüklenir. IO hatası ortaya çıkarsa, errorHandler() yöntemi de çağrılır ve hata mesajı ilerleme raporuna yönelik metin alanına yazılır. İlerleyen bir yükleme işlemi olduğunda, bir ProgressEvent.PROGRESS olayı gönderilir ve progressHandler() yöntemi çağrılır. Burada, ProgressEvent.PROGRESS olayı yükleme ilerleyişini hesaplamak için bir zamanlayıcı olarak kullanılır.

progressHandler() yöntemi, yüklenmekte olan ses verisinin yüzdesine ulaşmak için,·ProgressEvent nesnesiyle iletilen bytesLoaded değerini bytesTotal değerine böler. Ardından, bu değerleri metin alanında görüntüler. (Dosyanın küçük, önbelleğe alınmış veya yerel dizinde bulunması durumunda, ilerleme fark edilmeyebilir.)

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

()yöntem 
public function loadCompressedDataFromByteArray(bytes:ByteArray, bytesLength:uint):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 3, Flash Player 11

bir ByteArray nesnesinden Sound nesnesine MP3 ses verisi yükler. Veri geçerli ByteArray konumundan okunur ve bittiğinde ByteArray konumunu belirtilen bayt uzunluğunun sonunda bırakır. MP3 ses verisi ID3 verileri içeriyorsa bu işlev çağrısı sırasında ID3 olayları gönderilir. ByteArray nesnesi yeteri kadar veri içermiyorsa bu işlev istisna gönderir.

Parametreler

bytes:ByteArray
 
bytesLength:uint

loadPCMFromByteArray

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

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 3, Flash Player 11

Bir ByteArray nesnesinden Sound nesnesine PCM 32 bit kayan nokta ses verisi yükler. Veriler geçerli ByteArray konumundan okunur ve stereo bayrağı işlem tamamlandığında ayarlanırsa ByteArray konumunu, belirtilen örnek uzunluğu çarpı 1 kanal veya 2 kanal değerinde terk eder.

Flash Player 11.8'den başlamak üzere bu işleve iletilebilecek ses verisi miktarı sınırlıdır. 21'e eşit ve 21'den büyük SWF sürümlerinde bu işlev, söz konusu işleve iletilen ses verisi miktarının 1800 saniyeden fazla olması durumunda bir istisna verir. Yani, örnek sayısı / örnek hızı 1800'den az ya da 1800'e eşit olmalıdır. 21'den önceki swf sürümlerinde, iletilen ses verisi miktarı 12.000 saniyeden fazlaysa çalışma zamanı başarısız olur ve uyarı vermez. Bu işlev yalnızca geriye dönük uyumluluk için sağlanır.

ByteArray nesnesi yeteri kadar veri içermiyorsa bu işlev istisna gönderir.

Parametreler

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

play

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

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Sesi çalmak için yeni bir SoundChannel nesnesi üretir. Bu yöntem, sesi durdurmak ve ses düzeyini izlemek için erişebileceğiniz bir SoundChannel nesnesi döndürür. (Ses düzeyini, ses kaydırmayı ve dengeyi kontrol etmek için ses kanalına atanan SoundTransform nesnesine erişin.)

Parametreler

startTime:Number (default = 0) — Oynatmanın başlayacağı, milisaniye cinsinden ilk konum.
 
loops:int (default = 0) — Ses kanalı oynatmayı durdurmadan önce, sesin startTime değerine döneceği sayıyı tanımlar.
 
sndTransform:flash.media:SoundTransform (default = null) — Ses kanalına atanan ilk SoundTransform nesnesi.

Döndürür
SoundChannel — Sesi kontrol etmek için kullanabileceğiniz bir SoundChannel nesnesi. Bu yöntem, ses katınızın olmaması veya ses kanalınızın kalmaması durumunda null döndürür. Bir defada izin verilen maksimum ses kanalı sayısı 32'dir.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnekte, dosya yüklendiğinde, grafik çubuğu kullanan kullanıcı ses dosyasının başlangıç konumunu (başlangıç zamanı) seçebilir.

Yapıcı, ses verilerini yüklemek için Sound.load() yöntemini çağırır. Ardından, sesi yeteri kadar veri yüklenir yüklenmez çalmaya başlayacak olan Sound.play() yöntemini çağırır. Sound.play() yöntemi, ses oynatmayı kontrol etmek için kullanılabilecek bir SoundChannel nesnesi döndürür. Metin alanı talimatları görüntüler. Kullanıcının sesin başlamasını istediği yerdeki içeriklerin zaten yüklenmiş olduğundan emin olmak için bar Sprite nesnesi oluşturulur ve dosya yüklemesi bittikten sonra görüntülenir. Dosya başarıyla yüklendiğinde, bir Event.COMPLETE olayı gönderilir ve bu da completeHandler() yöntemini tetikler. Ardından, completeHandler() yöntemi çubuğu oluşturur ve görüntüleme listesine ekler. (Etkileşimliliği desteklemek için bir shape nesnesi yerine bir sprite nesnesi kullanılır.) Kullanıcı çubuğu tıkladığında, clickHandler() yöntemi tetiklenir.

clickHandler() yönteminde, kullanıcı tıklamasının x koordinatının konumu, event.localX, kullanıcının dosyanın başlamasını istediği yeri belirlemek için kullanılır. Çubuk 100 piksel olduğu ve 100 piksellik x koordinatında başladığı için, konumun yüzdesini belirlemek kolaydır. Aynı zamanda, dosya yüklendiği için, ses dosyasının length özelliği tam dosyanın milisaniye cinsinden uzunluğuna sahip olacaktır. Ses dosyasının uzunluğunu ve çizgideki konumu kullanarak, ses dosyası için bir başlangıç konumu belirlenir. Ses çalmayı durduktan sonra, ses dosyası play() yöntemine startTime parametresi olarak geçilen seçilmiş başlangıç konumundan yeniden başlar.

 
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;
        }
    }
}

Aşağıdaki örnekte, kullanıcının düğmeyi bir mi yoksa iki kere mi tıklattığına bağlı olarak ses bir veya iki kez çalar.

Yapıcıda, ses yüklenir ve basit bir dörtgen button sprite nesnesi oluşturulur. (Etkileşimliliği desteklemek için bir shape nesnesi yerine bir sprite nesnesi kullanılır.) Burada, ses dosyasının SWF dosyasıyla aynı dizin içinde olduğu varsayılmıştır. (Bu örnek için hata işlemesi kodu yoktur.)

Tek ve çift fare tıklatmalarına yanıt vermesi için iki olay dinleyicisi ayarlıdır. Kullanıcı bir kez tıklatırsa, sesi çalan clickHandler() yöntemi çağrılır. Kullanıcı düğmeyi iki kez tıklatırsa, dosyayı iki kez çalacak olan doubleClickHandler() yöntemi çağrılır. play() yönteminin ikinci argümanı 1 olarak ayarlanır, bu sesin bir kez başlangıç zamanına döneceği ve yeniden çalacağı anlamına gelir. Başlangıç zamanı, ilk argüman, 0 olarak ayarlanır, bu dosyanın başlangıçtan itibaren çalacağını gösterir.

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);        
        }
    }
}

Aşağıdaki örnek, bir ses dosyasının yüklenme ve çalınma ilerleyişini göstermektedir.

Yapıcıda dosya yüklenirken ortaya çıkabilecek herhangi bir hatanın yakalanması için, dosya bir try...catch bloğuna yüklenir. Ses nesnesine errorHandler() yöntemini çağırarak IOErrorEvent olayına yanıt verecek bir dinleyici eklenir. Ana uygulama için, oynatma ilerleyişini gösteren bir zamanlayıcı mekanizması olarak kullanılan Event.ENTER_FRAME olayına yanıt verecek başka bir dinleyici eklenir. Son olarak ses kanalı için, soundCompleteHandler() yöntemini çağırarak Event.SOUND_COMPLETE olayına yanıt verecek (ses çalmayı durdurduğunda) üçüncü bir dinleyici daha eklenir. soundCompleteHandler() yöntemi aynı zamanda Event.ENTER_FRAME olayına yönelik olay dinleyicisini de kaldırır.

enterFrameHandler() yöntemi, yüklenmekte olan ses verisinin yüzdesine ulaşmak için,·ProgressEvent nesnesiyle iletilen bytesLoaded değerini bytesTotal değerine böler. Çalınmakta olan ses verilerinin yüzdesi, ses kanalının position özelliğinin ses verisinin uzunluğuna bölünmesiyle belirlenebilir. Ancak, ses verisi tamamen yüklenmediyse, ses nesnesinin length özelliği yalnızca geçerli olarak yüklenen ses verisinin boyutunu gösterir. Tam ses dosyasının nihai boyutu, geçerli ses nesnesinin length değerinin, bytesTotal özelliğinin değerine bölünen bytesLoaded özelliğinin değerine bölünmesiyle tahmin edilebilir.

Dosyanın küçük, önbelleğe alınmış veya yerel dizinde bulunması durumunda, yükleme ilerlemesi fark edilmeyebilir. Aynı zamanda, ses verisinin yüklenmeye başlaması ve yüklenen verinin çalmaya başlaması arasındaki gecikme süresi, varsayılan olarak 1000 milisaniye olan ve sıfırlanabilen SoundLoaderContext.buffertime özelliği tarafından belirlenir.

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);
        }
    }
}
Olay Ayrıntısı

complete

Olay
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.COMPLETE

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Veriler başarılı şekilde yüklendiğinde gönderilir.

Event.COMPLETE sabiti, complete olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetYüklemesi tamamlanan network nesnesi.

İlgili API Öğeleri

id3

Olay  
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.ID3

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir MP3 ses dosyasında ID3 dosyası bulunduğunda bir Sound nesnesi tarafından gönderilir.

Event.ID3 sabiti, id3 olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetID3 verilerinin şimdi kullanılabilir olduğu MP3'ü yükleyen Sound nesnesi. target her zaman olay dinleyicisini kaydeden görüntüleme listesindeki nesne değildir. Geçerli olarak olayı işleyen görüntüleme listesindeki nesneye erişmek için currentTarget özelliğini kullanın.

İlgili API Öğeleri

ioError

Olay  
Olay Nesne Türü: flash.events.IOErrorEvent
özellik IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir yükleme işleminin başarısız olmasına neden olan bir girdi/çıktı hatası ortaya çıktığında gönderilir.

ioError olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
errorIDBelirli bir hata mesajıyla ilişkili başvuru numarası (yalnızca AIR).
targetGirdi/çıktı hatası yaşayan network nesnesi.
textHata mesajı olarak gösterilecek metin.

İlgili API Öğeleri

open

Olay  
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.OPEN

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

Bir yükleme işlemi başladığında gönderilir.

Event.OPEN sabiti, open olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetBağlantıyı açan network nesnesi.

İlgili API Öğeleri

progress

Olay  
Olay Nesne Türü: flash.events.ProgressEvent
özellik ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Lite 4

İndirme işleminin ilerlemesi sırasında veri alındığında gönderilir.

Bir progress olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
bytesLoadedDinleyici olayı işlerken yüklenen öğe veya bayt sayısı.
bytesTotalYükleme işlemi başarılı olursa yüklenecek toplam öğe veya bayt sayısı.
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetİlerlemeyi bildiren nesne.

İlgili API Öğeleri

sampleData

Olay  
Olay Nesne Türü: flash.events.SampleDataEvent
özellik SampleDataEvent.type = flash.events.SampleDataEvent.SAMPLE_DATA

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 10, AIR 1.5

Çalışma zamanı yeni ses verileri istediğinde gönderilir.

SampleDataEvent olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
positionSes verilerinin sağlandığı nokta.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek, basit bir sinüs dalgası oynatır.
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();

İlgili API Öğeleri

SoundExample.as

Aşağıdaki örnek, bir MP3 dosyasının açılıp çalındığı sırada gerçekleşen ses olayları hakkında bilgiler görüntüler. Bu örneği çalıştırmak için, SWF dosyanızla aynı dizine MySound.mp3 adlı bir dosya yerleştirin.
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 ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.