| 套件 | flash.events |
| 類別 | public class DRMAuthenticateEvent |
| 繼承 | DRMAuthenticateEvent  Event Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
DRMAuthenticateEvent 處理常式負責收集所需的憑證 (例如使用者名稱、密碼和類型) 並將這些值傳送給 NetStream.setDRMAuthenticationCredentials() 方法以供驗證。每個 AIR 應用程式都必須提供某些機制以取得使用者憑證。例如，應用程式可為使用者提供簡單的使用者介面以輸入使用者名稱、密碼和類型 (選擇性) 值。
如果使用者驗證失敗，應用程式將重新嘗試驗證，並為 NetStream 物件傳送新的 DRMAuthenticateEvent 事件。
相關 API 元素
公用屬性
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| authenticationType : String [唯讀]
指出提供的憑證是針對 Flash Media Rights Management Server (FMRMS) 還是 Proxy 伺服器進行驗證。 | DRMAuthenticateEvent | ||
 | bubbles : Boolean [唯讀]
指出事件是否為反昇事件。 | Event | |
| cancelable : Boolean [唯讀]
指出是否可避免與事件相關聯的行為指令。 | Event | |
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| currentTarget : Object [唯讀]
正主動使用事件偵聽程式處理 Event 物件的物件。 | Event | |
| eventPhase : uint [唯讀]
事件流程中的目前階段。 | Event | |
| header : String [唯讀]
伺服器所提供的加密內容檔案檔頭。 | DRMAuthenticateEvent | ||
| netstream : NetStream [唯讀]
起始此事件的 NetStream 物件。 | DRMAuthenticateEvent | ||
| passwordPrompt : String [唯讀]
由伺服器提供，要求提供密碼憑證的提示。 | DRMAuthenticateEvent | ||
| target : Object [唯讀]
事件目標。 | Event | |
| type : String [唯讀]
事件類型。 | Event | |
| urlPrompt : String [唯讀]
由伺服器提供，要求提供 URL 字串的提示。 | DRMAuthenticateEvent | ||
| usernamePrompt : String [唯讀]
由伺服器提供，要求提供使用者名稱憑證的提示。 | DRMAuthenticateEvent | ||
公用方法
| 方法 | 定義自 | ||
|---|---|---|---|
DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)
建立包含 DRM 驗證事件特定資訊的 Event 物件。 | DRMAuthenticateEvent | ||
[覆寫]
建立 DRMAuthenticateEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。 | DRMAuthenticateEvent | ||
|
公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
如果可以取消事件的預設行為指令，則取消該行為指令。 | Event | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | |
|
避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。 | Event | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
[覆寫]
傳回包含 DRMAuthenticateEvent 物件所有屬性的字串。 | DRMAuthenticateEvent | ||
|
會傳回指定之物件的基本值。 | Object | |
公用常數
| 常數 | 定義自 | ||
|---|---|---|---|
| AUTHENTICATION_TYPE_DRM : String = "drm" [靜態]
DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM 常數會定義 DRMAuthenticateEvent 物件的 authenticationType 屬性值。 | DRMAuthenticateEvent | ||
| AUTHENTICATION_TYPE_PROXY : String = "proxy" [靜態]
DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY 常數會定義 DRMAuthenticateEvent 物件的 authenticationType 屬性值。 | DRMAuthenticateEvent | ||
| DRM_AUTHENTICATE : String = "drmAuthenticate" [靜態]
DRMAuthenticateEvent.DRM_AUTHENTICATE 常數會定義 DRMAuthenticateEvent 物件的 type 屬性值。 | DRMAuthenticateEvent | ||
屬性詳細資訊
authenticationType | 屬性 |
authenticationType:String [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
指出提供的憑證是針對 Flash Media Rights Management Server (FMRMS) 還是 Proxy 伺服器進行驗證。例如，如果企業需要的話，"proxy" 選項可讓應用程式針對 Proxy 伺服器進行驗證，使用者才能存取網際網路。除非使用匿名驗證，否則在經過 Proxy 驗證之後，使用者仍必須針對 FMRMS 進行驗證，才能取得憑證並播放內容。您可以搭配 "drm" 選項再次使用 setDRMAuthenticationcredentials()，以針對 FMRMS 進行驗證。
實作
public function get authenticationType():String header | 屬性 |
netstream | 屬性 |
passwordPrompt | 屬性 |
urlPrompt | 屬性 |
usernamePrompt | 屬性 |
建構函式詳細資料
DRMAuthenticateEvent | () | 建構函式 |
public function DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
建立包含 DRM 驗證事件特定資訊的 Event 物件。Event 物件會當做參數傳遞至事件偵聽程式。
參數type:String — 事件類型。事件偵聽程式可以透過繼承的 type 屬性來存取此資訊。DRMAuthenticate 事件只有一種類型：DRMAuthenticateEvent.DRM_AUTHENTICATE。
| |
bubbles:Boolean (default = false)bubbles 屬性來存取此資訊。
| |
cancelable:Boolean (default = false)cancelable 屬性來存取此資訊。
| |
header:String (default = " | |
userPrompt:String (default = " | |
passPrompt:String (default = " | |
urlPrompt:String (default = " | |
authenticationType:String (default = " | |
netstream:NetStream (default = null) |
方法詳細資訊
clone | () | 方法 |
toString | () | 方法 |
override public function toString():String| 執行階段版本: | AIR 1.0 |
傳回包含 DRMAuthenticateEvent 物件所有屬性的字串。此字串的格式如下：
[DRMAuthenticateEvent type=value bubbles=value cancelable=value eventPhase=value header=value usernamePrompt=value passwordPrompt=value urlPrompt=value] authenticationType=value
String — 包含 DRMAuthenticateEvent 物件所有屬性的字串。
|
常數詳細資訊
AUTHENTICATION_TYPE_DRM | 常數 |
public static const AUTHENTICATION_TYPE_DRM:String = "drm"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM 常數會定義 DRMAuthenticateEvent 物件的 authenticationType 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
authenticationType | 指出提供的憑證是針對 Flash Media Rights Management Server (FMRMS) 還是 Proxy 伺服器進行驗證。 |
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
header | 伺服器所提供的加密內容檔案檔頭。 |
netstream | 起始此事件的 NetStream 物件。 |
passwordPrompt | 由伺服器提供，要求提供密碼憑證的提示。 |
target | NetStream 物件。 |
urlPrompt | 由伺服器提供，要求顯示 URL 的提示。 |
usernamePrompt | 由伺服器提供，要求提供使用者名稱憑證的提示。 |
相關 API 元素
AUTHENTICATION_TYPE_PROXY | 常數 |
public static const AUTHENTICATION_TYPE_PROXY:String = "proxy"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY 常數會定義 DRMAuthenticateEvent 物件的 authenticationType 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
authenticationType | 指出提供的憑證是針對 Flash Media Rights Management Server (FMRMS) 還是 Proxy 伺服器進行驗證。 |
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
header | 伺服器所提供的加密內容檔案檔頭。 |
netstream | 起始此事件的 NetStream 物件。 |
passwordPrompt | 由伺服器提供，要求提供密碼憑證的提示。 |
target | NetStream 物件。 |
urlPrompt | 由伺服器提供，要求顯示 URL 的提示。 |
usernamePrompt | 由伺服器提供，要求提供使用者名稱憑證的提示。 |
相關 API 元素
DRM_AUTHENTICATE | 常數 |
public static const DRM_AUTHENTICATE:String = "drmAuthenticate"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
DRMAuthenticateEvent.DRM_AUTHENTICATE 常數會定義 DRMAuthenticateEvent 物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
authenticationType | 指出提供的憑證是針對 Flash Media Rights Management Server (FMRMS) 還是 Proxy 伺服器進行驗證。 |
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
header | 伺服器所提供的加密內容檔案檔頭。 |
netstream | 起始此事件的 NetStream 物件。 |
passwordPrompt | 由伺服器提供，要求提供密碼憑證的提示。 |
target | NetStream 物件。 |
urlPrompt | 由伺服器提供，要求顯示 URL 的提示。 |
usernamePrompt | 由伺服器提供，要求提供使用者名稱憑證的提示。 |
相關 API 元素
範例 如何使用本範例
DRMAuthenticateEventExample.as
package
{
import flash.display.Sprite;
import flash.events.AsyncErrorEvent;
import flash.events.NetStatusEvent;
import flash.events.DRMAuthenticateEvent;
import flash.media.Video;
import flash.net.NetConnection;
import flash.net.NetStream;
public class DRMAuthenticateEventExample extends Sprite
{
var videoURL:String = "Video.flv";
var videoConnection:NetConnection;
var videoStream:NetStream;
var video:Video = new Video();
public function DRMAuthenticateEventExample()
{
videoConnection = new NetConnection();
videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
videoConnection.connect(null);
}
private function connectStream():void {
videoStream = new NetStream(videoConnection);
videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
videoStream.addEventListener(DRMAuthenticateEvent.DRM_AUTHENTICATE, drmAuthenticateEventHandler);
video.attachNetStream(videoStream);
videoStream.play(videoURL);
addChild(video);
}
private function netStatusHandler(event:NetStatusEvent):void {
switch (event.info.code) {
case "NetConnection.Connect.Success":
connectStream();
break;
case "NetStream.Play.StreamNotFound":
trace("Unable to locate video: " + videoURL);
break;
}
}
private function asyncErrorHandler(event:AsyncErrorEvent):void {
// ignore AsyncErrorEvent events.
}
private function drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void {
videoStream.setDRMAuthenticationCredentials("User", "password", "drm");
}
}
}
Tue Jun 12 2018, 03:47 PM Z