Обеспечивает взаимодействие SWF-файла с проигрывателем Flash Player или программой, содержащей Flash Player, например веб-обозревателем. Чтобы передать сообщения в Director или в Visual Basic, Visual C++ и другие программы, способные вмещать управляющие элементы ActiveX, можно также использовать функцию fscommand().

Функция fscommand() обеспечивает взаимодействие SWF-файла со сценарием на веб-странице. Но доступ к сценариям контролируется параметрами allowScriptAccess для веб-страниц. (Этот атрибут устанавливается в коде HTML, встроенном в SWF-файл. Например, в тег PARAM для Internet Explorer или тег EMBED для Netscape.)

• Если свойство allowScriptAccess имеет значение sameDomain (по умолчанию), работа со сценариями разрешена только для SWF-файлов, находящихся в том же домене, что и веб-страница.
• Если свойство allowScriptAccess имеет значение "always", SWF-может обращаться к HTML-странице, в которую он встроен, даже если он находится на другом домене.
• Если свойство allowScriptAccess имеет значение "never", SWF-файл не может обращаться ни к каким HTML-страницам. Обратите внимание, что использование этого значения не рекомендуется. Оно не требуется, если на вашем собственном домене не обслуживаются недоверенные SWF-файлы. В случае необходимости обслуживать недоверенный SWF-файлы Adobe рекомендует создать отдельный субдомен, на который следует помещать все недоверенное содержимое.

Можно запретить использование SWF-файлом этого метода путем установки параметра allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.

Функция fscommand() не разрешена, если вызывающий SWF-файл находится вне локальной файловой системы или изолированной сетевой среды, а содержащая его страница HTML находится не в доверенной изолированной среде.

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

• Раздел центра разработки Flash Player: Безопасность

Применение 1: чтобы использовать функцию fscommand() для отправки сообщения проигрывателю Flash Player, необходимо использовать предварительно определенные команды и параметры. В следующей таблице показаны значения, которые можно указать для передаваемых с функцией fscommand() параметровcommand и args. Эти значения управляют SWF-файлам, воспроизводимыми в проигрывателе Flash Player, включая проекторы. (Проектором называют SWF-файл, сохраненный в формате, который позволяет выполнять его в автономном приложении, то есть, не используя проигрыватель Flash Player.)

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

• Ни одна из этих команд не доступна в веб-проигрывателях.
• Все эти команды доступны в автономных приложениях, таких как проекторы.
• Только команды allowscale и exec доступны в проигрывателях тестовых роликов.

Команда exec может содержать только символы A-Z, a-z, 0-9, точку (.) и подчеркивание (_). Команда exec выполняется только в подкаталоге fscommand. Другими словами, если для вызова приложения используется команда exec, это приложение должно находиться в подкаталоге с названием fscommand. Команда exec работает только из файла проектора Adobe Flash.

Применение 2: чтобы использовать функцию fscommand() для отправки сообщения с использованием языка сценариев, например JavaScript в веб-обозревателе, можно передать любые два параметра, используя параметрыcommand и args. Эти параметры могут быть строками или выражениями, они используются в функции JavaScript, которая обрабатывает или перехватывает функцию fscommand().

В веб-обозревателе функция fscommand() вызывает функцию JavaScript moviename_DoFScommand, которая находится на веб-странице, содержащей SWF-файл. Для moviename укажите имя объекта Adobe Flash, используемого в качестве атрибута NAME для тега EMBED или свойства ID тега OBJECT. Если SWF-файлу назначается имя myMovie, вызывается функция JavaScript myMovie_DoFScommand.

На веб-странице, содержащей SWF-файл, установите атрибут allowScriptAccess, разрешив или запретив возможность доступа к веб-странице из этого SWF-файла, как описано выше. (Этот атрибут устанавливается в коде HTML, встроенном в SWF-файл. Например, в тег PARAM для Internet Explorer или тег EMBED для Netscape.)

Применение 3: функция fscommand() может отправлять сообщения в программу Director (Adobe Macromedia Director). Эти сообщения интерпретируются в Lingo (языке сценариев, используемом в Director) как строки, события или выполняемый код Lingo. Если сообщение является строкой или событием, необходимо написать код Lingo для получения сообщения из функции fscommand() и выполнить это действие в Director. Дополнительные сведения см. в центре поддержки Director по адресу www.adobe.com/support/director/.

Применение 4: в VisualBasic, Visual C++ и других программах, в которых можно размещать управляющие элементы ActiveX, функция fscommand() отправляет событие VB с двумя строками, которые могут обрабатываться языком программирования, используемом в среде. Дополнительные сведения можно найти по ключевым словам "Flash method" в центре поддержки Adobe Flash по адресу www.adobe.com/support/flash/.

Примечание. Класс ExternalInterface обеспечивает лучшую функциональность для взаимодействия между JavaScript и ActionScript (Применение 2), а также между ActionScript и VisualBasic, Visual C++ или другими программами, которые могут содержать управляющие элементы ActiveX (Применение 4). Необходимо продолжать использовать функцию fscommand() для отправки сообщений в проигрыватель Flash Player (Применение 1) и программу Director (Применение 3).

Параметры

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.system.fscommand;
    import flash.events.MouseEvent;

    public class FSCommandExample extends Sprite {
        private var bgColor:uint = 0xFFCC00;
        private var size:uint = 100;

        public function FSCommandExample() {
            fscommand("fullscreen", "true");
            fscommand("allowscale", "false");
            draw();
        }

        private function clickHandler(event:MouseEvent):void {
            fscommand("quit");
            trace("clickHandler");
        }

        private function draw():void {
            var child:Sprite = new Sprite();
            child.graphics.beginFill(bgColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            child.buttonMode = true;
            addEventListener(MouseEvent.CLICK, clickHandler);

            var label:TextField = new TextField();
            label.text = "quit";
            label.selectable = false;
            label.mouseEnabled = false;
            child.addChild(label);

            addChild(child);
        }
    }
}