適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: 從伺服器擷取資料...
從伺服器擷取資料...
fl.video 

INCManager  - AS3 Flash

套件fl.video
介面public interface INCManager
實作者 NCManager, NCManagerNative

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

INCManager 是為 VideoPlayer 類別建立 flash.net.NetConnection 之類別的介面。 預設的 INCManager 實作是 NCManager 類別。 從 Flash Media Server (FMS) 進行串流處理時,請使用 NCManagerNative 類別。 您也可以建立實作 INCManager 介面的自訂類別,然後讓 VideoPlayer 類別使用該類別來建立 NetConnection。

請使用下列程式碼,將自訂類別註冊為 VideoPlayer 物件使用的 INCManager 實作。 請以自訂類別取代 fl.video.NCManagerNative

fl.video.VideoPlayer.iNCManagerClass = fl.video.NCManagerNative;

相關 API 元素



公用屬性
 屬性定義自
  bitrate : Number
頻寬 (以每秒位元數為單位),用以在多個串流之間進行切換。
INCManager
  isRTMP : Boolean
[唯讀] 指出 URL 是來自 Flash Media Server (FMS) 的 RTMP 串流,或者是漸進式下載。
INCManager
  netConnection : NetConnection
[唯讀] NetConnection 物件的參照。
INCManager
  streamHeight : int
[唯讀] 串流的高度,以像素為單位。
INCManager
  streamLength : Number
[唯讀] 串流長度,以秒為單位。
INCManager
  streamName : String
[唯讀] 傳入 NetStream.play() 方法中的串流名稱。
INCManager
  streamWidth : int
[唯讀] 串流的寬度,以像素為單位。
INCManager
  timeout : uint
時間 (以毫秒為單位),經這段時間之後會嘗試停止進行連線。
INCManager
  videoPlayer : VideoPlayer
擁有此物件的 VideoPlayer 物件。
INCManager
公用方法
 方法定義自
  
關閉 NetConnection。
INCManager
  
會在連線成功但找不到串流時,由 VideoPlayer 物件呼叫。
INCManager
  
由 VideoPlayer 物件呼叫,以要求連線至 URL。
INCManager
  
getProperty(propertyName:String):*
會取得由實作 INCManager 之類別所支援的任意屬性之值。
INCManager
  
helperDone(helper:Object, success:Boolean):void
由正在進行工作的任何 helper 物件呼叫,以便讓 NCManager 物件發出表示它已經完成以及是否成功的訊號。
INCManager
  
由 VideoPlayer 物件呼叫,在連線中斷之後要求重新連線。
INCManager
  
setProperty(propertyName:String, value:*):void
會設定由實作 INCManager 之類別所支援的任意屬性之值。
INCManager
屬性詳細資訊

bitrate

屬性
bitrate:Number

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

頻寬 (以每秒位元數為單位),用以在多個串流之間進行切換。



實作
    public function get bitrate():Number
    public function set bitrate(value:Number):void

isRTMP

屬性 
isRTMP:Boolean  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

指出 URL 是來自 Flash Media Server (FMS) 的 RTMP 串流,或者是漸進式下載。 如果是來自 FMS 的 RTMP 串流,則為 true。 如果是 HTTP 漸進式下載串流、本機或其他檔案,則為 false



實作
    public function get isRTMP():Boolean

netConnection

屬性 
netConnection:NetConnection  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

NetConnection 物件的參照。



實作
    public function get netConnection():NetConnection

streamHeight

屬性 
streamHeight:int  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

串流的高度,以像素為單位。 呼叫 VideoPlayer.ncConnected() 方法之後,如果 streamHeight 屬性小於 0,即是對 VideoPlayer 物件表示沒有串流高度資訊。 如果 VideoPlayer 物件具有設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIOVideoScaleMode.NO_SCALEscaleMode 屬性,便會使用這個值,同時立即進行大小調整,而不會等候。



實作
    public function get streamHeight():int

相關 API 元素

streamLength

屬性 
streamLength:Number  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

串流長度,以秒為單位。 呼叫 VideoPlayer.ncConnected() 方法之後,如果傳回 undefined、null 或小於 0 的值,VideoPlayer 物件便會知道沒有串流長度的資訊。 如果傳回串流長度資訊,它就會覆寫任何現有的串流長度資訊,包括由 VideoPlayer.play() 方法或 VideoPlayer.load() 方法的 totalTime 參數設定的資訊,或者從 FLV 檔的中繼資料接收的資訊。



實作
    public function get streamLength():Number

相關 API 元素

streamName

屬性 
streamName:String  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

傳入 NetStream.play() 方法中的串流名稱。



實作
    public function get streamName():String

streamWidth

屬性 
streamWidth:int  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

串流的寬度,以像素為單位。 呼叫 VideoPlayer.ncConnected() 方法之後,如果 streamWidth 屬性小於 0,即是對 VideoPlayer 物件表示沒有串流寬度資訊。 如果 VideoPlayer 物件具有設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIOVideoScaleMode.NO_SCALEscaleMode 屬性,便會使用這個值,同時立即進行大小調整,而不會等候。



實作
    public function get streamWidth():int

相關 API 元素

timeout

屬性 
timeout:uint

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

時間 (以毫秒為單位),經這段時間之後會嘗試停止進行連線。



實作
    public function get timeout():uint
    public function set timeout(value:uint):void

videoPlayer

屬性 
videoPlayer:VideoPlayer

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

擁有此物件的 VideoPlayer 物件。



實作
    public function get videoPlayer():VideoPlayer
    public function set videoPlayer(value:VideoPlayer):void
方法詳細資訊

close

()方法
public function close():void

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

關閉 NetConnection。

connectAgain

()方法 
public function connectAgain():Boolean

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

會在連線成功但找不到串流時,由 VideoPlayer 物件呼叫。 如果 RTMP URL 的多重替代轉譯是可行的,它就會重新嘗試使用不同的 URL 連線至伺服器,然後傳回不同的串流名稱。

在 URL 類似 rtmp://servername/path1/path2/path3 的情況下,這是必要的步驟。 傳入應用程式名稱和實體名稱時,請使用 rtmp://servername/path1/path2 開啟 NetConnection 物件,或使用預設實體,以便藉由 path2/path3 開啟串流。 一般而言,每當路徑有兩個以上的部分時,這都是可行的;但是如果只有兩個部分 (絕對不會只有一個部分) 則行不通。

傳回值
Boolean — 如果嘗試建立其他連線,則為 true。如果已經嘗試進行連線,或者沒有其他任何需要嘗試的連線,則為 false

相關 API 元素

connectToURL

()方法 
public function connectToURL(url:String):Boolean

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

由 VideoPlayer 物件呼叫,以要求連線至 URL。 一旦連線成功或失敗,便會呼叫 VideoPlayer.ncConnected() 方法。 如果連線失敗,請在呼叫前先設定 nc = null

參數

url:String — VideoPlayer 物件要求進行連線的 URL。

傳回值
Boolean — 如果是以同步方式進行連線,則為 true。 如果是非同步進行嘗試,也就是呼叫者必須等待即將發生的 "connected" 事件,則為 false

相關 API 元素

getProperty

()方法 
public function getProperty(propertyName:String):*

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

會取得由實作 INCManager 之類別所支援的任意屬性之值。 如需支援的屬性清單,請參閱特定的實作類別。 對不支援的屬性呼叫此方法會擲回 VideoError 物件,其代碼為:VideoError.UNSUPPORTED_PROPERTY=1011

參數

propertyName:StringgetProperty 方法要呼叫的屬性名稱。

傳回值
* — 屬性的值。

helperDone

()方法 
public function helperDone(helper:Object, success:Boolean):void

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

由正在進行工作的任何 helper 物件呼叫,以便讓 NCManager 物件發出表示它已經完成以及是否成功的訊號。 NCManager 物件會搭配 SMILManager 使用此屬性。

參數

helper:Object — helper 物件。
 
success:Boolean — 要在完成工作時以訊號傳達的設定。 如果 successtrue,表示已成功完成工作;否則為 false

reconnect

()方法 
public function reconnect():void

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

由 VideoPlayer 物件呼叫,在連線中斷之後要求重新連線。 在連線成功或失敗之後,請呼叫 VideoPlayer.ncReconnected() 方法。 如果連接失敗,則在呼叫前先設定 nc = null

相關 API 元素

setProperty

()方法 
public function setProperty(propertyName:String, value:*):void

語言版本: ActionScript 3.0
產品版本: Flash CS3
執行階段版本: Flash Player 9.0.28.0, AIR 1.0

會設定由實作 INCManager 之類別所支援的任意屬性之值。 如需支援的屬性清單,請參閱特定的實作類別。 對不支援的屬性呼叫此方法會擲回 VideoError 物件,其代碼為:VideoError.UNSUPPORTED_PROPERTY=1011

參數

propertyName:StringsetProperty 方法要呼叫的屬性名稱。
 
value:* — 屬性值。





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

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