適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: AIR 30.0 和更早版本, Flash Player 30.0 和更早版本, Flash Lite 4
Flex 4.6 和更早版本, Flash Pro CS6 和更早版本
隱藏篩選
flash.media 

SoundMixer  - AS3

套件x

最上層
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

語言元素

全域常數
全域函數
運算子
陳述式、關鍵字和指令
特殊類型

附錄

新增內容
編譯器錯誤
編譯器警告
執行階段錯誤
移轉至 ActionScript 3
支援的字元集
僅限 MXML 標籤
移動 XML 元素
Timed Text 標籤
不建議元素清單
AccessibilityImplementation 常數
如何使用 ActionScript 範例
法律聲明
套件flash.media
類別public final class SoundMixer
繼承SoundMixer Inheritance Object

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

SoundMixer 類別包含應用程式中全域聲音控制的靜態屬性和方法。SoundMixer 類別會控制應用程式中的內嵌聲音和串流聲音,以及動態建立的聲音 (也就是為回應傳送 sampleData 事件之 Sound 物件而產生的聲音)。



公用屬性
 屬性定義自
      audioPlaybackMode : String
[靜態] 指定所有 Sound 物件的音訊播放模式。
SoundMixer
  bufferTime : int
[靜態] 開始串流之前,將內嵌串流聲音預先載入緩衝區的秒數。
SoundMixer
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
  soundTransform : flash.media:SoundTransform
[靜態] 可控制全域聲音屬性的 SoundTransform 物件。
SoundMixer
      useSpeakerphoneForVoice : Boolean
[靜態] 在裝置處於語音模式時切換免持聽筒。
SoundMixer
公用方法
 方法定義自
  
[靜態] 會判斷是否有任何聲音因為安全性限制而無法存取。
SoundMixer
  
computeSpectrum(outputArray:ByteArray, FFTMode:Boolean = false, stretchFactor:int = 0):void
[靜態] 會拍攝目前聲波的快照,然後將它放置於指定的 ByteArray 物件中。
SoundMixer
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
  
[靜態] 會停止目前正在播放的所有聲音。
SoundMixer
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
會傳回指定之物件的字串形式。
Object
 Inherited
會傳回指定之物件的基本值。
Object
屬性詳細資訊
    

audioPlaybackMode

屬性
audioPlaybackMode:String

語言版本: ActionScript 3.0
執行階段版本: AIR 3

指定所有 Sound 物件的音訊播放模式。在行動裝置上,這個屬性會根據平台用語來設定聲音屬性和預設值。在桌上型電腦和電視環境中,音訊播放模式並無功能上的差異。

這個屬性的有效值定義於 AudioPlaybackMode 類別中。

注意:在 iOS 上,如果一個應用程式設定 audioPlaybackMode=AudioPlaybackMode.VOICE,其他應用程式便無法將它變更為 AudioPlaybackMode.MEDIA

盡量減少使用 AudioPlaybackMode.VOICE 模式,並在語音呼叫結束時儘快嘗試切換為 AudioPlaybackMode.MEDIA 模式,以允許其他應用程式以媒體模式播放。

當您在 iOS 上變更音訊播放模式時,原生應用程式會短暫暫停播放音樂。

預設值為 AudioPlaybackMode.MEDIA。



實作
    public static function get audioPlaybackMode():String
    public static function set audioPlaybackMode(value:String):void

擲回值
ArgumentError — kInvalidParameterError

相關 API 元素

bufferTime

屬性 
bufferTime:int

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

開始串流之前,將內嵌串流聲音預先載入緩衝區的秒數。 除非您實作跨網域原則檔,否則已載入聲音中的資料 (包括其緩衝時間) 無法由不同網域中的 SWF 檔存取。如需安全性和聲音的詳細資訊,請參閱 Sound 類別的說明。除非您實作跨網域原則檔,否則已載入聲音中的資料 (包括其緩衝時間) 無法由不同網域中檔案的程式碼存取。但在 AIR 應用程式的應用程式安全執行程序中,程式碼可以存取來自任何來源的聲音檔中的資料。如需安全性和聲音的詳細資訊,請參閱 Sound 類別的說明。

SoundMixer.bufferTime 屬性只會影響 SWF 中內嵌串流聲音的緩衝時間,與以動態方式建立的 Sound 物件 (亦即,在 ActionScript 中建立的 Sound 物件) 無關。 SoundMixer.bufferTime 的值無法覆寫或設定預設緩衝時間 (在傳遞至 Sound.load() 方法的 SoundLoaderContext 物件中指定)。



實作
    public static function get bufferTime():int
    public static function set bufferTime(value:int):void

相關 API 元素

soundTransform

屬性 
soundTransform:flash.media:SoundTransform

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

可控制全域聲音屬性的 SoundTransform 物件。 SoundTransform 物件包含可用來設定音量、左右相位、指定左邊喇叭,以及指定右邊喇叭的屬性。 此屬性中所使用的 SoundTransform 物件會提供最終聲音設定,而這些設定會在套用任何個別聲音設定後,套用至所有聲音。



實作
    public static function get soundTransform():flash.media:SoundTransform
    public static function set soundTransform(value:flash.media:SoundTransform):void

相關 API 元素

    

useSpeakerphoneForVoice

屬性 
useSpeakerphoneForVoice:Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在裝置處於語音模式時切換免持聽筒。當 SoundMixer.audioPlaybackMode 設定為 AudioPlaybackMode.VOICE 時,智慧型手機依預設會使用電話耳機做為音訊輸入。useSpeakerphoneForVoice 屬性可讓您覆寫預設輸出,以便在手機應用程式中實作免持聽筒按鈕。這個屬性在 AudioPlaybackMode.VOICE 以外的模式中不會發揮作用。在桌上型電腦和電視環境中,這個屬性沒有作用。

注意:在 iOS 上,如果您的應用程式已經設定 audioPlaybackMode=VOICE,並且另一個應用程式也在語音模式中播放,便無法設定 useSpeakerphoneForVoice=true

注意:在 Android,您必須在 AIR 應用程式描述器設定 android.permission.MODIFY_AUDIO_SETTINGS,否則變更此值不會產生作用。此外,此設定是全域裝置設定。裝置上執行的其他應用程式則可以隨時變更基礎裝置設定。

預設值為 false。



實作
    public static function get useSpeakerphoneForVoice():Boolean
    public static function set useSpeakerphoneForVoice(value:Boolean):void

相關 API 元素

方法詳細資訊

areSoundsInaccessible

()方法
public static function areSoundsInaccessible():Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9

會判斷是否有任何聲音因為安全性限制而無法存取。 例如,如果聲音的載入來源網域與呼叫這個方法之內容所在的網域不同,並且此聲音的伺服器沒有 URL 原則檔案 (可授與該網域的網域存取權限),則無法存取此聲音。雖然仍可載入並播放此聲音,但您無法在不可存取的聲音上執行低階作業,例如取得聲音的 ID3 中繼資料。

針對應用程式安全執行程序中的 AIR 應用程式內容,呼叫這個方法一定會傳回 false。應用程式安全執行程序中的內容可存取所有聲音,包括從其它網域載入的聲音。

傳回值
Boolean — Boolean 的字串形式。

相關 API 元素

computeSpectrum

()方法 
public static function computeSpectrum(outputArray:ByteArray, FFTMode:Boolean = false, stretchFactor:int = 0):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9

會拍攝目前聲波的快照,然後將它放置於指定的 ByteArray 物件中。 這些值會格式化成一般化的浮點值 (範圍介於 -1.0 到 1.0 之間),並且傳遞給 outputArray 參數的 ByteArray 物件會覆寫成這些新的值。 所建立的 ByteArray 物件大小會固定為 512 個浮點值,其中前 256 個值表示左聲道,而後 256 個值則表示右聲道。

注意:這個方法會受限於本機檔案安全性和跨網域載入的限制。如果要使用本機檔案或不是從呼叫內容網域伺服器載入的聲音,您可能需要透過跨網域原則檔來處理安全執行程序限制。如需詳細資訊,請參閱 Sound 類別的說明。 此外,這個方法無法用來從 RTMP 串流擷取資料,即使它是由與 RTMP 伺服器位於相同網域的內容呼叫也一樣。

Flash Player 9.0.115.0 和更新版本以及 Adobe AIR 透過 RTMP 支援此方法。您可以使用伺服器端指令碼控制 Flash Media Server 上串流的存取。如需詳細資訊,請參閱「Adobe Flash Media Server 伺服器端 ActionScript 語言參考」中的 Client.audioSampleAccessClient.videoSampleAccess 屬性。

參數

outputArray:ByteArray — ByteArray 物件,其中會存放與聲音相關聯的值。 如果任何聲音由於安全性限制 (areSoundsInaccessible == true) 而無法使用,outputArray 物件就會維持不變。 如果停止所有聲音,就會以零來填滿 outputArray 物件。
 
FFTMode:Boolean (default = false) — Boolean 值,指出是否會先在聲音資料上執行傅利葉轉換。 將此參數設定為 true 會導致方法傳回頻譜,而非原始聲波。 在頻譜中,低頻是在左邊表示,而高頻是在右邊表示。
 
stretchFactor:int (default = 0) — 聲音樣本的解析度。 如果您將 stretchFactor 值設定為 0,就會在 44.1 KHz 取樣資料。如果此值設定為 1,就會在 22.05 KHz 取樣資料。如果此值設定為 2,就會在 11.025 KHz 取樣資料,依此類推。

相關 API 元素


範例  ( 如何使用本範例 )

下列範例使用 computeSpectrum() 方法產生聲波資料的圖形格式。

建構函式中會載入聲音檔案,並設定為開始播放 (這個範例沒有錯誤處理功能,而且假設該聲音檔案與 SWF 檔在相同目錄中)。 這個範例會在聲音播放時偵聽 Event.ENTER_FRAME 事件,一再重複觸發 onEnterFrame() 方法,以繪製聲音資料值的圖形。 當聲音播放完畢時,onPlaybackComplete() 方法會移除 Event.ENTER_FRAME 事件的偵聽程式,以停止繪圖程序。

onEnterFrame() 方法中,computeSpectrum() 方法會將原始聲音儲存在 bytes 位元組陣列物件中。 資料會以 44.1 KHz 的頻率取樣。 包含 512 個位元組資料的位元組陣列,其中每個各包含一個介於 -1 和 1 之間的浮點值。 前 256 個值代表左聲道,後 256 個值代表右聲道。 第一個 for 迴圈會讀取前 256 個資料值 (左立體聲道),並使用 Graphics.lineTo() 方法從每個點繪製線條到下一個點 (聲音波形的向量圖像顯示會直接寫入類別的 Sprite 物件)。 聲音位元組是以 32 位元浮點數的形式從位元組串流中讀取,而且會乘上圖形高度,以產生圖形的垂直範圍。 寬度設定為聲道長度的兩倍寬度。 第二個 for 迴圈會讀取下一組 256 個值 (右立體聲道),並以相反的順序繪製線條。 g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);g.lineTo(0, PLOT_HEIGHT); 方法會繪製波形的基線。 所產生的波形圖會呈現鏡像的效果。

package {
    import flash.display.Sprite;
    import flash.display.Graphics;
    import flash.events.Event;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.media.SoundMixer;
    import flash.net.URLRequest;
    import flash.utils.ByteArray;
    import flash.text.TextField;

    public class SoundMixer_computeSpectrumExample extends Sprite {

        public function SoundMixer_computeSpectrumExample() {
            var snd:Sound = new Sound();
            var req:URLRequest = new URLRequest("Song1.mp3");
            snd.load(req);
            
            var channel:SoundChannel;
            channel = snd.play();
            addEventListener(Event.ENTER_FRAME, onEnterFrame);
            channel.addEventListener(Event.SOUND_COMPLETE, onPlaybackComplete);
        }

        private function onEnterFrame(event:Event):void {
            var bytes:ByteArray = new ByteArray();
            const PLOT_HEIGHT:int = 200;
            const CHANNEL_LENGTH:int = 256;

            SoundMixer.computeSpectrum(bytes, false, 0);
            
            var g:Graphics = this.graphics;
            
            g.clear();
       
            g.lineStyle(0, 0x6600CC);
            g.beginFill(0x6600CC);
            g.moveTo(0, PLOT_HEIGHT);
            
            var n:Number = 0;
            
            for (var i:int = 0; i < CHANNEL_LENGTH; i++) {
                n = (bytes.readFloat() * PLOT_HEIGHT);
                g.lineTo(i * 2, PLOT_HEIGHT - n);
            }

            g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);
            g.endFill();
 
            g.lineStyle(0, 0xCC0066);
            g.beginFill(0xCC0066, 0.5);
            g.moveTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);
            
            for (i = CHANNEL_LENGTH; i > 0; i--) {
                n = (bytes.readFloat() * PLOT_HEIGHT);
                g.lineTo(i * 2, PLOT_HEIGHT - n);
            }
  
            g.lineTo(0, PLOT_HEIGHT);
            g.endFill();
        }
        
        private function onPlaybackComplete(event:Event):void {
            removeEventListener(Event.ENTER_FRAME, onEnterFrame);
        }
    }
}

stopAll

()方法 
public static function stopAll():void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會停止目前正在播放的所有聲音。

>在 Flash Professional 中,這個方法不會停止播放磁頭。設定為串流的聲音會隨著播放磁頭移到它們所位於的影格時繼續播放。

使用此屬性時,必須考慮下列安全性模型:

  • 根據預設,呼叫 SoundMixer.stopAll() 方法只會停止與呼叫此方法之物件位於相同安全執行程序中的聲音。 播放作業與呼叫之物件不是從相同安全執行程序開始的任何聲音則不會停止。
  • 當您使用 Sound 類別的 load() 方法載入聲音時,可以指定 context 參數 (SoundLoaderContext 物件)。 如果您將 SoundLoaderContext 物件的 checkPolicyFile 屬性設定為 trueFlash Player 或 Adobe AIR 就會檢查載入聲音的伺服器是否有跨網域原則檔案。如果伺服器具有跨網域原則檔案,而且此檔案允許呼叫內容的網域,則該檔案就可以使用 SoundMixer.stopAll() 方法來停止載入的聲音,否則就無法停止聲音。

但在 Adobe AIR 中,application 安全執行程序中的內容 (使用 AIR 應用程式所安裝的內容) 沒有這些安全性限制。

如需安全性詳細資訊,請參閱「Flash Player 開發人員中心」主題:安全性


範例  ( 如何使用本範例 )

下列範例使用 stopAll() 方法,將兩個同時播放的聲音設為靜音。

建構函式中會載入兩個不同的聲音檔案,並設定為開始播放。 第一個聲音於本機載入,並指定給聲道 (假設該檔案與 SWF 檔在相同目錄中)。 第二個檔案會從 Adobe 網站載入並進行串流處理。 為了能夠使用 SoundMixer.stopAll() 方法,所有聲音都必須可供存取 (可使用 SoundLoaderContext 物件檢查跨網域原則檔案)。 每個聲音都有事件偵聽程式,會在載入聲音檔案期間發生 IO 錯誤時叫用。 此外,還會建立 muteButton 文字欄位。 它會偵聽按一下滑鼠事件,進而叫用 muteButtonClickHandler() 方法。

muteButtonClickHandler() 方法中,如果文字欄位內容是 "MUTE",areSoundsInaccessible() 方法會檢查混音器能否存取該檔案。 如果可以存取該檔案,stopAll() 方法就會停止聲音。 如果再次選取文字欄位,第一個聲音又會開始播放,而且文字欄位的內容會變回 "MUTE"。這一次,stopAll() 方法會將執行中的聲音設定靜音。 請注意,聲道 stop() 方法也可用來停止指定給該聲道的特定聲音 (若要使用聲道功能,每次叫用 play() 方法時都必須將聲音重新指定給聲道)。

package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;
    import flash.media.SoundLoaderContext;
    import flash.media.SoundChannel;
    import flash.media.SoundMixer;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.events.MouseEvent;
    import flash.events.IOErrorEvent;

    public class SoundMixer_stopAllExample extends Sprite  {
        private var firstSound:Sound = new Sound();
        private var secondSound:Sound = new Sound();
        private var muteButton:TextField = new TextField();
        private var channel1:SoundChannel = new SoundChannel();
        
        public function SoundMixer_stopAllExample() {
            firstSound.load(new URLRequest("mySound.mp3"));
            secondSound.load(new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3"));

            firstSound.addEventListener(IOErrorEvent.IO_ERROR, firstSoundErrorHandler);
            secondSound.addEventListener(IOErrorEvent.IO_ERROR, secondSoundErrorHandler);
            
            channel1 = firstSound.play();
            secondSound.play();
            
            muteButton.autoSize = TextFieldAutoSize.LEFT;
            muteButton.border = true;
            muteButton.background = true;
            muteButton.text = "MUTE";
        
            muteButton.addEventListener(MouseEvent.CLICK, muteButtonClickHandler);         
        
            this.addChild(muteButton);
        }

        private function muteButtonClickHandler(event:MouseEvent):void {

            if(muteButton.text == "MUTE") {        
  
                if(SoundMixer.areSoundsInaccessible() == false) {
                    SoundMixer.stopAll();
                    muteButton.text = "click to play only one of sound.";
                }
                else {
                    muteButton.text = "The sounds are not accessible.";
                }
            }
           else {
                firstSound.play();        
                muteButton.text = "MUTE";
           }
        } 

        private function firstSoundErrorHandler(errorEvent:IOErrorEvent):void {
            trace(errorEvent.text);
        }

        private function secondSoundErrorHandler(errorEvent:IOErrorEvent):void {
            trace(errorEvent.text);
        }
    }
}




[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。