URLStream  - AS3

會傳回可在輸入緩衝區中讀取之資料的位元組數。 使用者程式碼必須呼叫 bytesAvailable 屬性，確定在嘗試以其中一種 read 方法進行讀取之前，具有足夠的資料。

指出此 URLStream 物件目前是否已連線。 如果 URLStream 物件已連線，則呼叫這個屬性會傳回 true 值，否則會傳回 false。

表示資料的位元組順序。可能值為 Endian.BIG_ENDIAN 或 Endian.LITTLE_ENDIAN。

預設值為 Endian.BIG_ENDIAN。

相關 API 元素

會控制寫入或讀取物件時使用的 Action Message Format (AMF) 版本。

相關 API 元素

會立即關閉串流並取消下載作業。 在呼叫 close() 方法後，便無法從串流讀取任何資料。

會開始下載 request 參數中指定的 URL。

注意： 如果正在下載的檔案包含非 ASCII 字元 (例如，許多非英文語系字元)，建議您將檔案儲存為 UTF-8 或 UTF-16 編碼，而不要儲存為類似 ASCII 的非 Unicode 格式。

如果載入作業立即失敗，就會擲回描述失敗的 IOError 或 SecurityError (包括本機檔案安全性錯誤) 例外； 否則，如果 URL 下載順利開始下載，便會傳送 open 事件，或者在發生錯誤時會傳送錯誤事件。

根據預設，呼叫的 SWF 檔與您所載入的 URL 必須位於完全相同的網域中。例如，www.adobe.com 的 SWF 檔只能從同樣在 www.adobe.com 中的來源載入資料。 若要從不同的網域載入資料，請在存放該資料的伺服器上放置一個 URL 原則檔案。

您無法從 Flash Player 連線到常用的保留連接埠。完整的封鎖連接埠清單，請參閱在「ActionScript 3.0 開發人員指南」中的「限制網路 API」。

在 Flash Player 中，如果您希望防止 SWF 檔使用此方法，可以在包含 SWF 內容的 HTML 頁面中，設定 object 和 embed 標籤的 allowNetworking 參數。

在 Flash Player 10 和 AIR 1.5 及其更新版本，如果您使用包含上載 (由 POST 主體中 "content-disposition" 檔頭的 "filename" 參數指示) 的多部分 Content-Type (例如 "multipart/form-data")，POST 作業會受限於上載所套用的安全性規則：

• 必須執行 POST 作業，以回應使用者啟動的動作 (例如按下滑鼠或按下按鍵)。
• 如果 POST 作業會跨越網域 (POST 目標與傳送 POST 要求的 SWF 檔不在同一部伺服器上)，目標伺服器必須提供允許跨網域存取的 URL 原則。

此外，多部分的 Content-Type 語法必須有效 (符合 RFC2046 標準)。如果語法無效，POST 作業會受限於上載所套用的安全性規則。

這些規則僅適用於非應用程式安全執行程序中的 AIR 內容。但在 Adobe AIR 中，位於應用程式安全執行程序的內容 (使用 AIR 應用程式所安裝的內容) 沒有這些安全性限制。

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

在 AIR 中，URLRequest 物件能夠註冊 httpResponse 狀態事件。與 httpStatus 事件不同，httpResponseStatus 事件在傳送任何回應資料之前會行先傳送。此外，httpResponseStatus 事件也包含 responseHeaders 和 responseURL 屬性的值 (尚未針對 httpStatus 事件而定義)。請注意，httpResponseStatus (如果有的話) 將在 (另外) 任何 complete 或 error 事件之前傳送。

如果「已有」httpResponseStatus 事件偵聽程式，就「一定」會傳送回應訊息的主體，而且 HTTP 狀態碼回應必然造成 complete 事件。無論 HTTP 回應狀態碼指出成功或錯誤都是如此。

在 AIR 中，如果「沒有」httpResponseStatus 事件偵聽程式，其行為將因 SWF 版本而異：

• 若為 SWF 9 內容，只有當 HTTP 回應狀態碼指出成功時，才會傳送 HTTP 回應訊息的主體。反之 (一旦發生錯誤) 便不會傳送任何主體，且 URLRequest 物件將傳送 IOError 事件。
• 若為 SWF 10 內容，「一律」會傳送 HTTP 回應訊息的主體。一旦發生錯誤，URLRequest 物件將傳送 IOError 事件。

參數

會從串流讀取 Boolean 值。 會讀取單一位元組。若該位元組不為零，則會傳回 true；否則傳回 false。

會從串流讀取具有正負號的位元組。

傳回的值會介於 -128 到 127 的範圍之間。

會從串流讀取資料的 length 位元組。 這些位元組會讀入 bytes 指定的 ByteArray 物件，並且會從 offset 位元組開始讀入 ByteArray 物件。

參數

會從串流讀取 IEEE 754 雙精度浮點數。

會從串流讀取 IEEE 754 單精度浮點數。

會從串流讀取具有正負號的 32 位元整數。

傳回的值會介於 -2147483648 到 2147483647 的範圍之間。

會使用指定的字元集，從位元組串流讀取指定之長度的多位元組字串。

參數

會從通訊端讀取物件，以 Action Message Format (AMF) 編碼。

相關 API 元素

會從串流讀取具有正負號的 16 位元整數。

傳回的值會介於 -32768 到 32767 的範圍之間。

會從串流讀取無正負號的位元組。

傳回的值會介於 0 到 255 的範圍之間。

會從串流讀取無正負號的 32 位元整數。

傳回的值會介於 0 到 4294967295 的範圍之間。

會從串流讀取無正負號的 16 位元整數。

傳回的值會介於 0 到 65535 的範圍之間。

會從串流讀取 UTF-8 字串。 會假定此字串的前置詞為無正負號的短整數，以指示以位元組為單位的長度。

會從串流讀取 length UTF-8 位元組的序列，然後傳回字串。

參數

在順利載入資料時傳送。

這個事件具有下列屬性：

當 URLStream.load() 方法呼叫嘗試透過 HTTP 存取資料，而且 Adobe AIR 能夠偵測並傳回要求的狀態碼時傳送。

如果 URLStream 物件註冊 httpStatusEvent 事件，錯誤回應會被當做內容一樣地傳送。因此，當錯誤資料載入 URLStream 時，URLStream 會傳送 progress 和 complete 事件，而不會傳送 ioError 事件。

HTTPStatusEvent.HTTP_RESPONSE_STATUS 常數會定義 httpResponseStatus 事件物件的 type 屬性值。

這個事件具有下列屬性：

相關 API 元素

當 URLStream.load() 呼叫嘗試透過 HTTP 存取資料，而且 Flash Player 或 Adobe AIR 能夠偵測並傳回要求的狀態碼時傳送。(某些瀏覽器環境可能無法提供這項資訊)。 請注意，httpStatus (如果有的話) 將在 (另外) 任何 complete 或 error 事件之前傳送。

這個事件具有下列屬性：

相關 API 元素

發生輸入/輸出錯誤，因而導致載入作業失敗時傳送。

這個事件具有下列屬性：

相關 API 元素

在載入作業開始時傳送。

這個事件具有下列屬性：

相關 API 元素

在下載作業進行中收到資料時傳送。 您可以使用 URLStream 類別的方法，立即讀取已經收到的資料。

這個事件具有下列屬性：

相關 API 元素

會當 URLStream.load() 的呼叫嘗試從安全執行程序以外的伺服器載入資料時傳送。

這個事件具有下列屬性：

相關 API 元素

若要執行此範例，請將名為 URLStreamExample.swf 的檔案與 SWF 檔放置於相同的目錄中。

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

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

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

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

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

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