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.external 

ExternalInterface  - 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.external
Sınıfpublic final class ExternalInterface
Miras AlmaExternalInterface Inheritance Object

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

ExternalInterface sınıfı, ActionScript ile SWF kabı arasında düzgün iletişim gerçekleşmesini sağlayan bir uygulama programlama arabirimidir– örneğin, JavaScript içeren bir HTML sayfası veya SWF dosyasını görüntülemek için Flash Player kullanan bir masaüstü uygulaması.

ExternalInterface sınıfını kullanarak, HTML sayfasında JavaScript'i kullanıp Flash çalışma zamanında bir ActionScript işlevini çağırabilirsiniz. ActionScript işlevi, bir değer döndürebilir ve JavaScript derhal bu değeri çağrının dönüş değeri olarak alır.

Bu işlev, fscommand() yönteminin yerini alır.

ExternalInterface sınıfını şu tarayıcı-işletim sistemi kombinasyonlarında kullanın:

Tarayıcıİşletim Sistemiİşletim Sistemi
Internet Explorer 5.0 ve sonrasıWindows 
Netscape 8.0 ve sonrasıWindowsMacOS
Mozilla 1.7.5 ve sonrasıWindowsMacOS
Firefox 1.0 ve sonrasıWindowsMacOS
Safari 1.3 ve sonrası MacOS

Linux sürüm 9.0.31.0 ve sonrası için Flash Player, şu tarayıcılarda ExternalInterface sınıfını destekler:

Tarayıcı
Mozilla 1.7.x ve sonrası
Firefox 1.5.0.7 ve sonrası
SeaMonkey 1.0.5 ve sonrası

ExternalInterface sınıfı, kullanıcının web tarayıcısının ActiveX ® veya eklenti komut dosyası oluşturma için bazı web tarayıcıları tarafından gösterilen NPRuntime API'lerini desteklemesini gerektirir. Yukarıda listelenmemiş olsa bile, NPRuntime API'yı destekleyen tarayıcı-işletim sistemi kombinasyonunun ExternalInterface sınıfını da desteklemesi gerekir. Bkz. http://www.mozilla.org/projects/plugins/npruntime.html.

Not: HTML sayfası içine SWF dosyaları gömerken, id niteliğinin ayarlı olduğundan ve object ile embed etiketlerine ait id ve name niteliklerinin şu karakterleri içermediğinden emin olun:

 . - + * / \
 

Flash Player uygulamaları için not: Flash Player sürüm 9.0.115.0 ve sonrası . (nokta) karakterini id ve name niteliklerinde destekler.

Flash Player uygulamaları için not: Bir tarayıcıda çalışan Flash Player 10 ve sonrasında, açılır pencere açmak için programlama yoluyla bu sınıfın kullanılması başarılı olmayabilir. Çeşitli tarayıcılar (ve tarayıcı konfigürasyonları), herhangi bir anda açılır pencereleri engelleyebilir; tüm açılır pencerelerin görüntüleneceği garanti edilemez. Ancak bunu başarmanın en iyi yolu, yalnızca kullanıcı eyleminin doğrudan sonucu olarak çalıştırılan bir kodda (örneğin, fare tıklatması veya tuş basışı olayı gibi bir olay işleyicisinde) açılır pencere açmak için bu sınıfın kullanılmasıdır.

ActionScript'te, HTML sayfası üzerinde şunları yapabilirsiniz:

  • Herhangi bir JavaScript işlevini çağırma.
  • Herhangi bir ada sahip herhangi bir sayıda argümanı iletme.
  • Çeşitli veri türlerini iletme (Boolean, Number, String vb.).
  • JavaScript işlevinden dönüş değeri alma.

JavaScript'te, HTML sayfası üzerinde şunları yapabilirsiniz:

  • ActionScript işlevi çağırma.
  • Standart işlev çağrı notasyonunu kullanarak argüman iletme.
  • JavaScript işlevine değer döndürme.

Flash Player uygulamaları için not: Flash Player şu anda HTML formlarında gömülü SWF dosyalarını desteklememektedir.

AIR uygulamaları için not: Adobe AIR'de, HTMLLoader deneyiminde yüklenen bir HTML sayfasındaki JavaScript ile o HTML sayfasında gömülü SWF içeriğindeki ActionScript arasında iletişim kurmak için ExternalInterface sınıfı kullanılabilir.

Örnekleri görüntüle

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
  available : Boolean
[statik] [salt okunur] Bu oynatıcının, harici arabirim sunan bir kap içinde olup olmadığını gösterir.
ExternalInterface
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
  marshallExceptions : Boolean = false
[statik] Harici arabirimin ActionScript istisnalarını geçerli tarayıcıya ve JavaScript istisnalarını Player’a iletmeyi deneyip denememesi gerektiğini belirtir.
ExternalInterface
  objectID : String
[statik] [salt okunur] Internet Explorer'da object etiketinin id niteliğini veya Netscape'de embed etiketinin name niteliğini döndürür.
ExternalInterface
Genel Yöntemler
 YöntemTanımlayan:
  
addCallback(functionName:String, closure:Function):void
[statik] ActionScript yöntemini kaptan çağrılabilir olarak kaydeder.
ExternalInterface
  
call(functionName:String, ... arguments):*
[statik] Sıfır veya daha fazla argüman ileterek, SWF kabı tarafından sunulan bir işlevi çağırır.
ExternalInterface
 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
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 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
Özellik Ayrıntısı

available

özellik
available: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

Bu player'ın, harici arabirim sunan bir kap içinde olup olmadığını gösterir. Harici arabirim kullanılabilir durumdaysa, bu özellik true olur; aksi takdirde, false olur.

Not: Harici API'yi HTML ile birlikte kullanırken herhangi bir JavaScript yöntemini çağırmayı denemeden önce her zaman HTML'in yüklemeyi tamamladığından emin olun.



Uygulama
    public static function get available():Boolean

Örnek  ( Bu örnek nasıl kullanılır? )
Aşağıdaki örnekte oynatıcının harici arabirim sunan bir kap içinde olup olmadığını belirlemek için available özelliği kullanılmaktadır.
     package {
       import flash.text.TextField;
       import flash.display.MovieClip;
       import flash.external.ExternalInterface;
     
       public class extint_test extends MovieClip {
         public function extint_test() {
           var isAvailable:Boolean = ExternalInterface.available;
           var availTxt:TextField = new TextField();
           availTxt.text = isAvailable.toString();
           addChild(availTxt);
         }
       }
     }
     

marshallExceptions

özellik 
public static var marshallExceptions:Boolean = false

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

Harici arabirimin ActionScript istisnalarını geçerli tarayıcıya ve JavaScript istisnalarını Player’a iletmeyi deneyip denememesi gerektiğini belirtir. ActionScript'teki JavaScript istisnalarını ve JavaScript'teki ActionScript istisnalarını yakalamak için bu özelliği açık bir şekilde true olarak ayarlamalısınız.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )
Aşağıdaki örnek bir ActionScript işlevi oluşturur ve addCallback() yöntemini kullanarak bu işlevi kapsayıcı tarayıcıya kaydeder. Yeni işlev, tarayıcıda yürütülen JavaScript kodunun yakalayabilmesi için bir istisna gönderir. Bu örnekte ayrıca try..catch ifadesi bulunur ve bu ifade throwit() işlevi çağrıldığında tarayıcı tarafından gönderilen istisnaları yakalar.
package
{
    import flash.external.*
    import flash.net.*;
    import flash.display.*;
    import flash.system.System;
    public class ext_test extends Sprite {
    function ext_test():void {
        ExternalInterface.marshallExceptions = true;
        ExternalInterface.addCallback("g", g);

        try {
        ExternalInterface.call("throwit");
        } catch(e:Error) {
        trace(e)
        }
    }
    function g() { throw new Error("exception from actionscript!!!!") }
    }
}

objectID

özellik 
objectID: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

Internet Explorer'da object etiketinin id niteliğini veya Netscape'de embed etiketinin name niteliğini döndürür.



Uygulama
    public static function get objectID():String
Yöntem Ayrıntısı

addCallback

()yöntem
public static function addCallback(functionName:String, closure:Function):void

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

ActionScript yöntemini kaptan çağrılabilir olarak kaydeder. addCallBack() öğesi başarıyla çağrıldıktan sonra oynatıcıdaki kayıtlı işlev, kaptaki JavaScript veya ActiveX koduyla çağrılabilir.

Not: Bir tarayıcıda yürütülen yerel içeriklerde ExternalInterface.addCallback() yöntemine yapılan çağrılar, yalnızca SWF dosyası ve kapsayıcı web sayfası yerel olarak güvenilen güvenlik sanal alanındaysa çalışır. Daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

functionName:String — Kabın işlevi çağırabileceği adı.
 
closure:Function — Çağrılacak işlev kapanışı. Bu, bağımsız bir işlev olabilir veya bir nesne öğesinin yöntemine başvuru yapan yöntem kapanışı olabilir. Bir yöntem kapanışı ileterek geri çağrıyı belirli bir örnek nesnesine ait bir yönteme yönlendirebilirsiniz.

Not: null kapanış değeriyle varolan bir geri çağrı işlevinde addCallback() öğesinin yinelenmesi sonucunda geri çağrı kaldırılır.


Atar
Error — Kap gelen çağrıları desteklemez. Gelen çağrılar, yalnızca Windows Internet Explorer'da ve Mozilla 1.7.5 ve sonrası ya da Firefox 1.0 ve sonrası gibi NPRuntime API kullanan tarayıcılarda desteklenir.
 
SecurityError — Belirtilen ada sahip bir geri çağırma, ActionScript tarafından erişiminizin olmadığı bir sanal alana zaten eklenmiş; bu geri çağrının üzerine yazamazsınız. Bu sorunu gidermek için, orijinal olarak addCallback() yöntemini çağıran ActionScript'i Security.allowDomain() yöntemini de çağıracak şekilde yeniden yazın.
 
SecurityError — Kapsayıcı ortam, çağrı kodunun erişiminin olmadığı bir güvenlik sanal alanına ait. Bu sorunu gidermek için şu adımları izleyin:
  1. Kapsayıcı HTML sayfasındaki SWF dosyasına yönelik object etiketinde şu parametreyi ayarlayın:

    <param name="allowScriptAccess" value="always" />

  2. SWF dosyasına şu ActionScript'i ekleyin:

    flash.system.Security.allowDomain(sourceDomain)

İlgili API Öğeleri

call

()yöntem 
public static function call(functionName:String, ... arguments):*

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

Sıfır veya daha fazla argüman ileterek, SWF kabı tarafından sunulan bir işlevi çağırır. İşlev kullanılabilir değilse çağrı null değerini döndürür; aksi takdirde işlevin sağladığı değeri döndürür. Opera veya Netscape tarayıcılarında kendi kendini yinelemeye izin verilmez; bu tarayıcılarda yinelemeli çağrı null yanıtını döndürür. (Kendi kendini yineleme, Internet Explorer ve Firefox tarayıcılarında desteklenir.)

Kap bir HTML sayfasıysa bu yöntem bir script öğesindeki JavaScript işlevini çağırır.

Kap başka bir ActiveX kabına, bu yöntem belirtilen ada sahip olan FlashCall ActiveX olayını gönderir ve kap bu olayı işler.

Kap, Netscape eklentisini barındırıyorsa yeni NPRuntime arabirimi için özel destek yazabilir veya bir HTML denetimi gömüp bu HTML denetiminin içine Player'ı gömebilirsiniz. Bir HTML denetimi gömerseniz, yerel kap uygulamasına giden bir JavaScript arabirimi aracılığıyla Player ile iletişim kurabilirsiniz.

Not: Bir tarayıcıda yürütülen yerel içeriklerde ExternalInterface.call() yöntemine yapılan çağrılar, yalnızca SWF dosyası ve kapsayıcı web sayfası (böyle bir sayfa varsa) yerel olarak güvenilen güvenlik sanal alanındaysa işlerlik kazanır. Ayrıca, SWF içeriğini kapsayan HTML sayfasındaki object ve embed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz. Daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Flash Player uygulamaları için not: Flash Player 10 ve Flash Player 9 Güncelleme 5'te, açılır pencere engelleyicisi etkinse, bazı web tarayıcıları bu yöntemi sınırlar. Bu senaryoda, bu yöntemi yalnızca bir kullanıcı olayına yanıt olarak başarıyla çağırabilirsiniz (örneğin, fare tıklatması veya tuşa basma olayı için bir olay işleyicisinde).

Parametreler

functionName:String — İşlevin kapta çağrılacak alfasayısal adı. Alfasayısal olmayan bir ad kullanılması, çalışma zamanı hatasına neden olur (hata 2155). Hatayı işlemek için try..catch bloğunu kullanabilirsiniz.
 
... arguments — Kaptaki işleve iletilecek argümanlar. Virgüllerle ayırarak sıfır veya daha fazla parametre belirtebilirsiniz. Bu parametreler, herhangi bir ActionScript veri türünde olabilir. Bir JavaScript işlevine çağrı yapıldığında ActionScript türleri otomatik olarak JavaScript türlerine dönüştürülür; başka bir ActiveX kabına çağrı yapıldığında parametreler istek mesajına kodlanır.

Döndürür
* — Kaptan alınan yanıt. Çağrı başarısız olduysa, örneğin kapta öyle bir işlev yoksa, arabirim kullanılabilir değilse, kendi kendini yineleme durumu ortaya çıktıysa (Netscape veya Opera tarayıcısında) veya güvenlik sorunu olursa null değeri döndürülür ve bir hata verilir.

Atar
Error — Kap giden çağrıları desteklemez. Giden çağrılar, yalnızca Windows Internet Explorer'da ve Mozilla 1.7.5 ve sonrası ya da Firefox 1.0 ve sonrası gibi NPRuntime API kullanan tarayıcılarda desteklenir.
 
SecurityError — Kapsayıcı ortam, çağrı kodunun erişiminin olmadığı bir güvenlik sanal alanına ait. Bu sorunu gidermek için şu adımları izleyin:
  1. Kapsayıcı HTML sayfasındaki SWF dosyasına yönelik object etiketinde şu parametreyi ayarlayın:

    <param name="allowScriptAccess" value="always" />

  2. SWF dosyasına şu ActionScript'i ekleyin:

    flash.system.Security.allowDomain(sourceDomain)


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

Aşağıdaki örnek, Flash Player'dan bir dizeyi, JavaScript alert() işlevi kullanılarak görüntüleneceği HTML kabına göndermek için ExternalInterface sınıfını (flash.external.ExternalInterface) nasıl kullanabileceğinizi gösterir. Örnek, ActionScriptExamples.com tarafından sağlanmıştır.
//
// Requires:
//   - A Flash Professional Label component on the Stage with an instance name of "lbl".
//   - A Flash Professional Button component on the Stage with an instance name of "button".
//
var xmlResponse:String = "<invoke name=\"isReady\" returntype=\"xml\"><arguments><number>1</number><number>" + stage.stageWidth + "</number><number>" + stage.stageHeight + "</number></arguments></invoke>";
 
lbl.text = "ExternalInterface.available: " + ExternalInterface.available;
lbl.width = 200;
button.enabled = ExternalInterface.available;
button.addEventListener(MouseEvent.CLICK, button_click);
 
function button_click(evt:MouseEvent):void {
    ExternalInterface.call("alert", xmlResponse);
}
ExternalInterfaceExample.as

Aşağıdaki örnekte, Flash Player ile HTML kabı arasında veri gönderme işlemi gösterilmektedir.
package  {
    
    import flash.display.Sprite;
    import flash.events.*;
    import flash.external.ExternalInterface;
    import flash.text.TextField;
    import flash.utils.Timer;
    import flash.text.TextFieldType;
    import flash.text.TextFieldAutoSize;
    import flash.system.Security;
    
    public class ExternalInterfaceExample extends Sprite 
    {
        
    private var input:TextField;
        private var output:TextField;
        private var sendBtn:Sprite;
        
        public function ExternalInterfaceExample() 
        {
            // constructor code
            Security.allowDomain("*");
            
            
            input = new TextField();
            input.type = TextFieldType.INPUT;
            input.background = true;
            input.border = true;
            input.width = 350;
            input.height = 18;
            addChild(input);

            sendBtn = new Sprite();
            sendBtn.mouseEnabled = true;
            sendBtn.x = input.width + 10;
            sendBtn.graphics.beginFill(0xcccccc);
            sendBtn.graphics.drawRoundRect(0, 0, 80, 18, 10, 10);
            sendBtn.graphics.endFill();
            sendBtn.addEventListener(MouseEvent.CLICK, clickHandler);
            addChild(sendBtn);

            output = new TextField();
            output.y = 25;
            output.width = 450;
            output.height = 325;
            output.multiline = true;
            output.wordWrap = true;
            output.border = true;
            output.text = "Initializing...\n";
            addChild(output);
            
            
            if (ExternalInterface.available) {
                try {
                    output.appendText("Adding callback...\n");
                    ExternalInterface.addCallback("sendToActionScript", receivedFromJavaScript);
                    if (checkJavaScriptReady()) {
                        output.appendText("JavaScript is ready.\n");
                    } else {
                        output.appendText("JavaScript is not ready, creating timer.\n");
                        var readyTimer:Timer = new Timer(100, 0);
                        readyTimer.addEventListener(TimerEvent.TIMER, timerHandler);
                        readyTimer.start();
                    }
                } catch (error:SecurityError) {
                    output.appendText("A SecurityError occurred: " + error.message + "\n");
                } catch (error:Error) {
                    output.appendText("An Error occurred: " + error.message + "\n");
                }
            } else {
                output.appendText("External interface is not available for this container.");
            }
        }
        private function receivedFromJavaScript(value:String):void {
            output.appendText("JavaScript says: " + value + "\n");
        }
        private function checkJavaScriptReady():Boolean {
            var isReady:Boolean = ExternalInterface.call("isReady");
            return isReady;
        }
        private function timerHandler(event:TimerEvent):void {
            output.appendText("Checking JavaScript status...\n");
            var isReady:Boolean = checkJavaScriptReady();
            if (isReady) {
                output.appendText("JavaScript is ready.\n");
                output.appendText("ExternalInterface.objectID = " + ExternalInterface.objectID + "\n");
                Timer(event.target).stop();
            }
        }
        private function clickHandler(event:MouseEvent):void {
            if (ExternalInterface.available) {
                ExternalInterface.call("sendToJavaScript", input.text);
            }
        }
    }
}


Önceki ActionScript kodunu test etmek için, oluşturulmuş SWF dosyasını şu HTML şablonunu kullanarak gömün:
 <!-- saved from url=(0014)about:internet -->
 <html lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <title>ExternalInterfaceExample</title>
 <script language="JavaScript">
     var jsReady = false;
     function isReady() {
         return jsReady;
     }
     function pageInit() {
         jsReady = true;
         document.forms["form1"].output.value += "\n" + "JavaScript is ready.\n";
     }
     function sendToActionScript(value) {
       document.getElementById("ExternalInterfaceExample").sendToActionScript(value);
     }
     function sendToJavaScript(value) {
         document.forms["form1"].output.value += "ActionScript says: " + value + "\n";
     }
 </script>
 </head>
 <body onload="pageInit();">
 
  <object id="ExternalInterfaceExample"  name="ExternalInterfaceExample" 
  type="application/x-shockwave-flash" data="ExternalInterfaceExample.swf" width="550" height="400">
    <param name="movie" value="ExternalInterfaceExample.swf"/>
    <param name="quality" value="high"/>
    <param name="allowscriptaccess" value="always"/>
    <a href="http://www.adobe.com/go/getflash">
        <img src="http://www.adobe.com/images/shared/download_buttons/get_flash_player.gif" alt="Get Adobe Flash player"/>
    </a>
  </object>
 
     <form name="form1" onsubmit="return false;">
         <input type="text" name="input" value="" />
         <input type="button" value="Send" onclick="sendToActionScript(this.form.input.value);" /><br />
         <textarea cols="60" rows="20" name="output" readonly="true">Initializing...</textarea>
     </form>
 
 </body>
 </html>
 




[ 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.