Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: AIR 30.0 или более ранней версии, Flash Player 30.0 или более ранней версии, Flash Lite 4
Flex 4.6 или более ранней версии, Flash Pro CS6 или более ранней версии
Скрыть фильтры
flash.net 

Socket  - 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
устаревший_индекс
Константы реализации специальных возможностей
Использование примеров
Юридическая информация
Пакетflash.net
Классpublic class Socket
НаследованиеSocket Inheritance EventDispatcher Inheritance Object
Реализует IDataInput, IDataOutput
Подклассы SecureSocket

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Класс Socket позволяет коду устанавливать подключения к сокетам TCP для отправки и получения бинарных данных.

Класс Socket применяется при работе с серверами, использующими двоичные протоколы.

Для использования методов класса Socket, необходимо сначала создать объект Socket с помощью конструктора new Socket.

Сокет передает и получает данные асинхронно.

В одних операционных системах метод flush() автоматически вызывается между кадрами выполнения, а в других, таких как Windows, данные никогда не отправляются, пока в коде не будет вызван метод flush(). Чтобы обеспечить надежное поведение приложения во всех операционных системах, рекомендуется вызывать метод flush() после записи каждого сообщения (или связанной группы данных) в сокет.

В Adobe AIR объекты Socket также создаются, когда прослушивающий экземпляр ServerSocket получает подключение от внешнего процесса. Объект Socket, представляющий подключение, отправляется в событии ServerSocketConnectEvent. Приложение должно поддерживать ссылку на объект Socket. В противном случае объект Socket подлежит сборке мусора и может быть без предупреждения уничтожен во время выполнения.

Содержимое SWF, выполняемое в изолированной среде безопасности, локальной для файловой системой, не может использовать сокеты.

Файлы политик сокетов на целевом узле определяют узлы, с которых SWF-файлы могут создавать подключения к сокетам, а также порты, доступные для таких подключений. В нескольких последних версиях Flash Player были ужесточены требования по безопасности относительно файлов политик сокетов. Компания Adobe рекомендует использовать файл политик для сокетов для всех версий Flash Player, а в некоторых случаях его применение является обязательным. Поэтому, если используются объекты Socket, проследите, чтобы целевой узел при необходимости предоставлял файл политик для сокетов.

В следующем списке приводятся все требования к файлам политик сокетов для разных версий Flash Player.

  • В Flash Player 9.0.124.0 и более поздних версиях файл политик для сокетов является обязательным для любого подключения Socket. Другими словами, файл политик для сокетов обязательно должен быть на целевом узле независимо от того, к какому порту выполняется подключение. Этот файл должен быть, даже если устанавливается подключение к порту на том же узле, на котором находится SWF-файл.
  • В приложении Flash Player 9.0.115.0 и более ранних версиях файл политик для сокетов на целевом узле является обязательным, если устанавливается подключение к порту с номером меньше 1024 или если требуется подключиться не к тому узлу, на котором размещен SWF-файл.
  • В Flash Player 9.0.115.0 при использовании отладочной версии проигрывателя в случае отсутствия файла политик для сокетов на целевом сервере отображается предупреждение, даже если файл политик для сокетов не является обязательным.
  • В AIR файл политики сокетов не является обязательным для содержимого, выполняемого в изолированной среде безопасности приложения. Файлы политик сокетов являются обязательными для любого подключения к сокету, устанавливаемого содержимым, выполняемым за пределами изолированной среды безопасности приложения AIR.

Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность

Посмотреть примеры

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
  bytesAvailable : uint
[только для чтения] Число байт данных, доступных для чтения во входном буфере.
Socket
  bytesPending : uint
[только для чтения] Указывает количество байт, оставшихся в буфере записи.
Socket
  connected : Boolean
[только для чтения] Определяет, подключен ли в настоящий момент этот объект Socket.
Socket
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  endian : String
Указывает порядок байтов для данных.
Socket
      localAddress : String
[только для чтения] IP-адрес, с которым связан этот сокет, на локальном компьютере.
Socket
      localPort : int
[только для чтения] Порт, с которым связан этот сокет, на локальном компьютере.
Socket
  objectEncoding : uint
Управляет версией AMF, применяемой при записи или чтении объекта.
Socket
      remoteAddress : String
[только для чтения] IP-адрес удаленного компьютера, к которому подключен этот сокет.
Socket
      remotePort : int
[только для чтения] Порт на удаленном компьютере, к которому подключен этот сокет.
Socket
  timeout : uint
Указывает время ожидания подключения в миллисекундах.
Socket
Общедоступные методы
 МетодОпределено
  
Socket(host:String = null, port:int = 0)
Создает новый объект Socket.
Socket
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
Закрывает сокет.
Socket
  
connect(host:String, port:int):void
Подключает сокет к заданному узлу и порту.
Socket
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
Очищает любые накопленные данные в выходном буфере сокета.
Socket
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Считывает из сокета логическое значение.
Socket
  
Считывает из сокета байт со знаком.
Socket
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Считывает из сокета число байт данных, заданное параметром length.
Socket
  
Считывает из сокета число IEEE 754 двойной точности с плавающей запятой.
Socket
  
Считывает из сокета число IEEE 754 одинарной точности с плавающей запятой.
Socket
  
Считывает из сокета 32-разрядное целое число со знаком.
Socket
  
readMultiByte(length:uint, charSet:String):String
Считывает многобайтовую строку из потока байт с использованием заданного набора знаков.
Socket
  
Считывает объект из сокета, зашифрованного в сериализованный формат AMF.
Socket
  
Считывает из сокета 16-разрядное целое число со знаком.
Socket
  
Считывает из сокета байт без знака.
Socket
  
Считывает из сокета 32-разрядное целое число без знака.
Socket
  
Считывает из сокета 16-разрядное целое число без знака.
Socket
  
Считывает из сокета строку UTF-8.
Socket
  
Считывает из сокета число байт данных UTF-8, заданное параметром length и возвращает строку.
Socket
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
  
Записывает логическое значение в сокет.
Socket
  
Записывает байт в сокет.
Socket
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Записывает последовательность байт из заданного массива байт.
Socket
  
Записывает в сокет число IEEE 754 двойной точности с плавающей запятой.
Socket
  
Записывает в сокет число IEEE 754 одинарной точности с плавающей запятой.
Socket
  
Записывает в сокет 32-разрядное целое число со знаком.
Socket
  
Записывает многобайтовую строку из потока байт с использованием заданного набора знаков.
Socket
  
Записывает объект в сокет в сериализованном формате AMF.
Socket
  
Записывает в сокет 16-разрядное целое число.
Socket
  
Записывает в сокет 32-разрядное целое число без знака.
Socket
  
Записывает следующие данные в сокет: 16-разрядное целое число без знака, указывающее на длину заданной строки UTF-8 в байтах, а затем саму строку.
Socket
  
Записывает строку UTF-8 в сокет.
Socket
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
  Отправляется, когда сервер закрывает подключение к сокету.Socket
  Отправляется после установления сетевого подключения.Socket
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
  Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции отправки или загрузки.Socket
  Передается при перемещении данных сокетом из буфера записи на уровень сетевого транспортаSocket
  Отправляется, если метод Socket.connect() предпринимает попытку подключиться к серверу, который запрещен изолированной средой безопасности вызывающего приложения, или к порту с номером меньше 1024, когда нет файла политики сокетов, разрешающего такое подключение.Socket
  Отправляется, когда сокет получает данные.Socket
Сведения о свойстве

bytesAvailable

свойство
bytesAvailable:uint  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Число байт данных, доступных для чтения во входном буфере.

В вашем коде должен быть вызов свойства bytesAvailable, проверяющий доступность необходимого объема данных до того, как вы попытаетесь сосчитать их с помощью одного из методов read.



Реализация
    public function get bytesAvailable():uint

bytesPending

свойство 
bytesPending:uint  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 11, AIR 3.0

Указывает количество байт, оставшихся в буфере записи.

Используйте это свойство вместе с OutputProgressEvent. Событие OutputProgressEvent отправляется каждый раз при записи данных из буфера записи в сетевое местоположение. В обработчике события можно проверить bytesPending, чтобы узнать, сколько данных осталось в буфере и ожидает записи. Когда bytesPending возвращает 0, это значит, что все данные переданы из буфера записи в сетевое местоположение и теперь можно удалять обработчики событий, обнулять ссылки на сокеты, начинать следующую отправку в очереди и т.д.



Реализация
    public function get bytesPending():uint

Связанные элементы API

connected

свойство 
connected:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Определяет, подключен ли в настоящий момент этот объект Socket. Вызов этого свойства возвращает значение true, если сокет в настоящий момент подключен, или значение false, если не подключен.



Реализация
    public function get connected():Boolean

endian

свойство 
endian:String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Определяет порядок байтов данных. Возможными значениями являются константы из класса flash.utils.Endian, Endian.BIG_ENDIAN или Endian.LITTLE_ENDIAN.

Значением по умолчанию является Endian.BIG_ENDIAN.



Реализация
    public function get endian():String
    public function set endian(value:String):void

Связанные элементы API

    

localAddress

свойство 
localAddress:String  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

IP-адрес, с которым связан этот сокет, на локальном компьютере.



Реализация
    public function get localAddress():String

Связанные элементы API

    

localPort

свойство 
localPort:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Порт, с которым связан этот сокет, на локальном компьютере.



Реализация
    public function get localPort():int

Связанные элементы API

objectEncoding

свойство 
objectEncoding:uint

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Управляет версией AMF, применяемой при записи или чтении объекта.



Реализация
    public function get objectEncoding():uint
    public function set objectEncoding(value:uint):void

Связанные элементы API

    

remoteAddress

свойство 
remoteAddress:String  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

IP-адрес удаленного компьютера, к которому подключен этот сокет.

С помощью этого свойства можно определить IP-адрес клиентского сокета, отправленный объектом ServerSocket в событии ServerSocketConnectEvent. Если потребуется, используйте класс DNSResolver для преобразования IP-адреса в имя домена.



Реализация
    public function get remoteAddress():String

Связанные элементы API

    

remotePort

свойство 
remotePort:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Порт на удаленном компьютере, к которому подключен этот сокет.

С помощью этого свойства можно определить номер порта клиентского сокета, отправленный объектом ServerSocket в событии ServerSocketConnectEvent.



Реализация
    public function get remotePort():int

Связанные элементы API

timeout

свойство 
timeout:uint

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Указывает время ожидания подключения в миллисекундах.

Если подключение не будет установлено в течение заданного срока, попытка завершается ошибкой. Значение по умолчанию: 20,000 (двадцать секунд).



Реализация
    public function get timeout():uint
    public function set timeout(value:uint):void
Сведения о конструкторе

Socket

()Конструктор
public function Socket(host:String = null, port:int = 0)

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Создает новый объект Socket. Если не указаны никакие параметры, создается первоначально отключенный сокет. Если параметры указаны, производится попытка подключиться к указанному узлу и порту.

Примечание. Настоятельно рекомендуется использовать форму конструктора без параметров, затем добавить любые прослушиватели событий, после чего вызвать метод connect с параметрами host и port. Эта последовательность гарантирует правильную работу всех приемников событий.

Параметры
host:String (default = null) — Полностью определенное имя домена DNS или IP-адрес. Адреса IPv4 указываются с использованием десятичного представления с разделителем-точкой, например 192.0.2.0. В приложении Flash Player 9.0.115.0 и AIR 1.0 и более поздней версии можно задать IPv6-адреса в шестнадцатеричном представлении с двоеточием, например 2001:db8:ccc3:ffff:0:444d:555e:666f. Также можно указать null, чтобы подключиться к серверу узла, на котором размещен рассматриваемый SWF-файл. Если SWF-файл, инициирующий данный вызов, запущен в веб-обозревателе, то в параметре host должен указываться тот же домен, в котором находится SWF-файл.
 
port:int (default = 0) — Номер TCP-порта на целевом узле, используемый для установки подключения. Для Flash Player 9.0.124.0 и более поздних версий на целевом узле должен быть файл политик для сокетов, разрешающий подключения к сокетам через указанный порт для узла, на котором размещен SWF-файл. Для более ранних версий Flash Player файл политик для сокетов является обязательным, только если требуется подключиться к порту с номером ниже 1024 или если SWF-файл находится не на том узле, к которому выполняется подключение.

События
connect:Event — Отправляется после установления сетевого подключения.
 
ioError:IOErrorEvent — Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою подключения.
 
securityError:SecurityErrorEvent Отправляется, если вызов Socket.connect() пытается установить подключение к серверу, на котором нет файла политик для сокетов, либо к серверу, на котором файл политик для сокетов не предоставляет вызывающему узлу доступ к указанному порту. Дополнительные сведения о файлах политик см. в главе «Элементы управления веб-сайтом (файлы политики)» в Руководстве разработчика по ActionScript 3.0, а также в разделе центра разработчиков Flash Player Developer Center: Безопасность.

Выдает
SecurityError — Эта ошибка возникает в содержимом SWF по следующим причинам:
  • Локальные для файловой системы файлы изолированы от Интернета. Данную проблему можно обойти, если переклассифицировать этот SWF-файл как локальный с сетевым подключением или доверенный. Это ограничение не применимо к содержимому приложения AIR в изолированной программной среде безопасности приложения.
  • Не допускается указывать номер порта сокета выше 65535.
Сведения о методе

close

()метод
public function close():void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Закрывает сокет. После вызова метода close() вы не сможете считать или записать какие-либо данные.

Событие close отправляется только в тот момент, когда сервер закрывает соединение. Оно не отправляется при вызове метода close().

Для повторного использования объекта Socket снова вызовите для него метод connect().


Выдает
IOError — Не удалось закрыть сокет или сокет не был открыт.

connect

()метод 
public function connect(host:String, port:int):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Подключает сокет к заданному узлу и порту.

Мгновенный сбой подключения приводит к отправке события или созданию исключения: если узел был указан, отправляется событие ошибки, а если узел не был указан, то создается исключение. В противном случае, состояние подключения сообщается посредством события. Если сокет уже подключен, то сначала закрывается именно существующее подключение.

Параметры

host:String — Имя или IP-адрес узла, к которому нужно подключиться. Если узел не указан, то обращение производится к тому узлу, на котором размещен вызывающий файл. Если узел не указан, для определения успешности подключения используйте прослушиватель событий.
 
port:int — Номер порта для подключения.


События
connect:Event — Отправляется после установления сетевого подключения.
 
ioError:IOErrorEvent — Отправляется, если узел указан, но возникает ошибка ввода-вывода, вызывающая сбой подключения.
 
securityError:SecurityErrorEvent — Отправляется, если вызов Socket.connect() пытается установить подключение к серверу, на котором нет файла политик для сокетов, либо к серверу, на котором файл политик для сокетов не предоставляет вызывающему узлу доступ к указанному порту. Дополнительные сведения о файлах политик см. в главе «Элементы управления веб-сайтом (файлы политики)» в Руководстве разработчика по ActionScript 3.0, а также в разделе центра разработчиков Flash Player Developer Center: Безопасность.

Выдает
IOError — Сбой подключения, так как не был указан узел.
 
SecurityError — Эта ошибка возникает в содержимом SWF по следующим причинам:
  • Локальные ненадежные SWF-файлы могут быть изолированы от Интернета. Можно устранить это ограничение, если переклассифицировать файл как локальный с сетевым подключением или доверенный.
  • Не допускается указывать номер порта сокета выше 65535.
  • На HTML-странице с SWF-cодержимым для параметра allowNetworking тегов object и embed устанавливается значение none.

flush

()метод 
public function flush():void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Очищает любые накопленные данные в выходном буфере сокета.

В одних операционных системах метод flush() автоматически вызывается между кадрами выполнения, а в других, таких как Windows, данные никогда не отправляются, пока в коде не будет вызван метод flush(). Чтобы обеспечить надежное поведение приложения во всех операционных системах, рекомендуется вызывать метод flush() после записи каждого сообщения (или связанной группы данных) в сокет.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readBoolean

()метод 
public function readBoolean():Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета логическое значение. После считывания одного байта метод возвращает true, если этот байт ненулевой, в противном случае, возвращается значение false.

Возвращает
Boolean — Значение равно true, если считывается ненулевой байт, в противном случае используется значение false.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readByte

()метод 
public function readByte():int

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета байт со знаком.

Возвращает
int — Значение в диапазоне от -128 до 127.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readBytes

()метод 
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета число байт данных, заданное параметром length. Байты считываются в указанный байтовый массив, при этом начальная позиция указывается в параметре offset.

Параметры

bytes:ByteArray — Объект ByteArray, в который считываются данные.
 
offset:uint (default = 0) — Смещение, с которого должно начинаться считывание данных в байтовом массиве.
 
length:uint (default = 0) — Число байтов для считывания. Если значение по умолчанию равно 0, считываются все доступные данные.


Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readDouble

()метод 
public function readDouble():Number

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета число IEEE 754 двойной точности с плавающей запятой.

Возвращает
Number — Число IEEE 754 двойной точности с плавающей запятой.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readFloat

()метод 
public function readFloat():Number

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета число IEEE 754 одинарной точности с плавающей запятой.

Возвращает
Number — Число IEEE 754 одинарной точности с плавающей запятой.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readInt

()метод 
public function readInt():int

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета 32-разрядное целое число со знаком.

Возвращает
int — Значение в диапазоне от -2147483648 до 2147483647.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readMultiByte

()метод 
public function readMultiByte(length:uint, charSet:String):String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает многобайтовую строку из потока байт с использованием заданного набора знаков.

Параметры

length:uint — Число считываемых из потока байтов.
 
charSet:String — Строка, обозначающая набор символов, которые используются для интерпретации байтов. Возможные строки наборов символов: shift_jis, CN-GB и iso-8859-1. Полный список см. в разделе Поддерживаемые наборы символов.

Примечание. Если текущая система не распознает значение параметра charSet, то в качестве набора символов приложение будет использовать кодовую страницу по умолчанию. Например, значение параметра charSet, например в myTest.readMultiByte(22, "iso-8859-01"), которое использует 01 вместо 1 может работать на вашем компьютере, но привести к сбою на другой рабочей станции. На другом компьютере приложение будет использовать кодовую страницу, заданную по умолчанию в системе.

Возвращает
String — Строка в кодировке UTF-8.

Выдает
EOFError — Недостаточно данных, доступных для чтения.

readObject

()метод 
public function readObject():*

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает объект из сокета, зашифрованного в сериализованный формат AMF.

Возвращает
* — Десериализованный объект

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

readShort

()метод 
public function readShort():int

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета 16-разрядное целое число со знаком.

Возвращает
int — Значение в диапазоне от -32768 до 32767.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readUnsignedByte

()метод 
public function readUnsignedByte():uint

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета байт без знака.

Возвращает
uint — Значение в диапазоне от 0 до 255.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readUnsignedInt

()метод 
public function readUnsignedInt():uint

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета 32-разрядное целое число без знака.

Возвращает
uint — Значение в диапазоне от 0 до 4294967295.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readUnsignedShort

()метод 
public function readUnsignedShort():uint

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета 16-разрядное целое число без знака.

Возвращает
uint — Значение в диапазоне от 0 до 65535.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readUTF

()метод 
public function readUTF():String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета строку UTF-8. Предполагается, что в строку вставляется префикс с неподписанным коротким целым числом, указывающим длину в байтах.

Возвращает
String — Строка UTF-8.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

readUTFBytes

()метод 
public function readUTFBytes(length:uint):String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Считывает из сокета число байт данных UTF-8, заданное параметром length и возвращает строку.

Параметры

length:uint — Число байтов для считывания.

Возвращает
String — Строка UTF-8.

Выдает
EOFError — Недостаточно данных, доступных для чтения.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

writeBoolean

()метод 
public function writeBoolean(value:Boolean):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает логическое значение в сокет. Данный метод записывает один байт со значением 1 (true) или 0 (false).

Параметры

value:Boolean — Значение, записываемое в сокете: 1 (true) или 0 (false).


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeByte

()метод 
public function writeByte(value:int):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает байт в сокет.

Параметры

value:int — Значение, записываемое в сокет. Используются 8 младших битов значения, а 24 старших бита игнорируются.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeBytes

()метод 
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает последовательность байт из заданного массива байт. Операция записи начинается в позиции, указанной в offset.

Если будет опущен параметр length, применение длины по умолчанию, равной 0, приведет к тому, что метод будет записывать весь буфер, начиная со смещения offset.

Если также опустить параметр offset, будет записываться весь буфер.

Параметры

bytes:ByteArray — Объект ByteArray, из которого должны записываться данные.
 
offset:uint (default = 0) — Нулевое смещение в объекте ByteArray bytes, с которого должна начаться запись данных.
 
length:uint (default = 0) — Число записываемых байтов. Использование значения по умолчанию, равного 0, приводит к записи всего буфера, начиная со значения, указанного параметром offset.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.
 
RangeError — Если значение offset превышает длину массива ByteArray, указанную в свойстве bytes или если сумма данных, указанная для записи в свойстве offset вместе со значением length превышает доступные данные.

Связанные элементы API

writeDouble

()метод 
public function writeDouble(value:Number):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает в сокет число IEEE 754 двойной точности с плавающей запятой.

Параметры

value:Number — Значение, записываемое в сокет.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeFloat

()метод 
public function writeFloat(value:Number):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает в сокет число IEEE 754 одинарной точности с плавающей запятой.

Параметры

value:Number — Значение, записываемое в сокет.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeInt

()метод 
public function writeInt(value:int):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает в сокет 32-разрядное целое число со знаком.

Параметры

value:int — Значение, записываемое в сокет.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeMultiByte

()метод 
public function writeMultiByte(value:String, charSet:String):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает многобайтовую строку из потока байт с использованием заданного набора знаков.

Параметры

value:String — Записываемое значение строки.
 
charSet:String — Строка, обозначающая набор символов, которые используются для интерпретации байтов. Возможные строки наборов символов: shift_jis, CN-GB и iso-8859-1. Полный список см. в разделе Поддерживаемые наборы символов.

Связанные элементы API

writeObject

()метод 
public function writeObject(object:*):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает объект в сокет в сериализованном формате AMF.

Параметры

object:* — Объект для сериализации.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeShort

()метод 
public function writeShort(value:int):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает в сокет 16-разрядное целое число. Записанные байты выглядят следующим образом:

(v >> 8) & 0xff v & 0xff

Используются 16 младших битов параметра, а 16 старших битов игнорируются.

Параметры

value:int — Значение, записываемое в сокет.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeUnsignedInt

()метод 
public function writeUnsignedInt(value:uint):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает в сокет 32-разрядное целое число без знака.

Параметры

value:uint — Значение, записываемое в сокет.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeUTF

()метод 
public function writeUTF(value:String):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает следующие данные в сокет: 16-разрядное целое число без знака, указывающее на длину заданной строки UTF-8 в байтах, а затем саму строку.

Перед тем как записать строку, метод рассчитывает количество байтов, необходимое для представления всех символов строки.

Параметры

value:String — Строка, записываемая в сокет.


Выдает
RangeError — Длина превышает 65535.
 
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

writeUTFBytes

()метод 
public function writeUTFBytes(value:String):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Записывает строку UTF-8 в сокет.

Параметры

value:String — Строка, записываемая в сокет.


Выдает
IOError — В сокете возникла ошибка ввода-вывода или сокет не был открыт.

Связанные элементы API

Сведения о событии

close

Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CLOSE

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Отправляется, когда сервер закрывает подключение к сокету.

Событие close отправляется только в тот момент, когда сервер закрывает соединение. Оно не отправляется при вызове метода Socket.close().

Константа Event.CLOSE определяет значение свойства type объекта события close.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, для которого разорвано подключение.

connect

Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CONNECT

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Отправляется после установления сетевого подключения.

Константа Event.CONNECT определяет значение свойства type объекта события connect.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект Socket или XMLSocket, установивший сетевое подключение.

ioError

Событие  
Тип объекта события: flash.events.IOErrorEvent
свойство IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции отправки или загрузки.

Задает значение свойства type для объекта события ioError.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
errorIDСсылочный номер, связываемый с конкретной ошибкой (только AIR).
targetСетевой объект, с которым произошла ошибка ввода/вывода.
textТекст, отображаемый в качестве сообщения об ошибке.

outputProgress

Событие  
Тип объекта события: flash.events.OutputProgressEvent

Передается при перемещении данных сокетом из буфера записи на уровень сетевого транспорта

securityError

Событие  
Тип объекта события: flash.events.SecurityErrorEvent
свойство SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Отправляется, если метод Socket.connect() предпринимает попытку подключиться к серверу, который запрещен изолированной средой безопасности вызывающего приложения, или к порту с номером меньше 1024, когда нет файла политики сокетов, разрешающего такое подключение.

Примечание. В приложении AIR содержимое, выполняемое внутри изолированной среды безопасности этого приложения, получает разрешение на подключение к любому серверу и порту без даже файла политики сокетов.

Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, сообщающий об ошибке безопасности.
textТекст, отображаемый в качестве сообщения об ошибке.

Связанные элементы API

socketData

Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.SOCKET_DATA

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Отправляется, когда сокет получает данные.

Данные, полученные сокетом, остаются в нем, пока не будут прочитаны. Необязательно считывать все доступные данные при обработке этого события.

В событиях типа socketData не используется свойство ProgressEvent.bytesTotal.

Задает значение свойства type для объекта события socketData.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий событие.
bytesLoadedЧисло элементов или байтов, загруженных на момент обработки события прослушивателем.
bytesTotal0; это свойство не используется объектами события socketData.
targetСокет, сообщающий сведения о прогрессе.
SocketExample.as

В следующем примере рассматриваются операции записи и чтения на сокете, а также вывод информации, переданной во время событий сокета. Основные моменты данного примера представлены ниже:
  1. Конструктор создает экземпляр CustomSocket с именем socket и передает в качестве аргументов имя узла localhost и порт 80. Так как CustomSocket расширяет Socket, вызов метода super() расширяет конструктор Socket.
  2. Затем в примере вызывается метод configureListeners(), добавляющий прослушивателей для событий Socket.
  3. В завершение, вызывается метод connect() сокета с именем узла localhost и номером порта 80.

Примечание. Для запуска данного примера вам потребуется сервер, запущенный в том же домене, где размещен SWF-файл (в данном примере: localhost), и прослушивающий порт 80.

package {
    import flash.display.Sprite;

    public class SocketExample extends Sprite {
        private var socket:CustomSocket;
        
        public function SocketExample() {
            socket = new CustomSocket("localhost", 80);
        }
    }
}

import flash.errors.*;
import flash.events.*;
import flash.net.Socket;

class CustomSocket extends Socket {
    private var response:String;

    public function CustomSocket(host:String = null, port:uint = 0) {
        super();
        configureListeners();
        if (host && port)  {
            super.connect(host, port);
        }
    }

    private function configureListeners():void {
        addEventListener(Event.CLOSE, closeHandler);
        addEventListener(Event.CONNECT, connectHandler);
        addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        addEventListener(ProgressEvent.SOCKET_DATA, socketDataHandler);
    }

    private function writeln(str:String):void {
        str += "\n";
        try {
            writeUTFBytes(str);
        }
        catch(e:IOError) {
            trace(e);
        }
    }

    private function sendRequest():void {
        trace("sendRequest");
        response = "";
        writeln("GET /");
        flush();
    }

    private function readResponse():void {
        var str:String = readUTFBytes(bytesAvailable);
        response += str;
    }

    private function closeHandler(event:Event):void {
        trace("closeHandler: " + event);
        trace(response.toString());
    }

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

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

    private function securityErrorHandler(event:SecurityErrorEvent):void {
        trace("securityErrorHandler: " + event);
    }

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




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.