2005年1月19日 星期三

FCS--Server端與Client端method觸發與data廣播概念

在FCS的應用上常會需要讓Client與Server間的資料傳遞與method呼叫,以下幾點概念應該可以避免
呼叫method沒反應或資料沒傳到你要的地方等狀況發生

一.Server端method如何被呼叫
Server端上要能讓Client所呼叫觸發的function,需定義在Server端的Client物件上
你可以用prototype方式去extend 原本Client 類別的method,讓Client類別所產生的
instance都擁有該method
例:
Client.prototype.newfun=function(){}
你也可以把這function定義在單一Client instance下,

例:
application.onConnect(newClient)=function(){
.....
newClient.newfun=function(){}
}

二.Client端的method如何被呼叫
在Client端上要讓Server端可以呼叫的function,一定要定義在Netconnection上
例:
nc=new NetConnection();
.....
nc.myfun=function(){}
三.send或call這兩個method在使用上有何差異?如何使用

call:這method在Client端上可使用的是netconnection物件,在Server端上可使用的是netconnection與Client物件

  1. 在Client端利用netconnection.call來觸發執行Server端上Client 物件的method

  2. 在Server端上利用Client物件.call來觸發Client端上netconnection上的method

  3. 在Server端上使用netconnection.call時,這時這server的角色就像一個client端一樣,是在觸發另一個Server
    端上Client 物件的method


send:在Client端上可使用這method的包含SharedObject與netStream。 send這個method很有趣,他讓你由client端去啟動所有同在client端的function,但因為在觸發function時可以帶
參數過去,這個特性是可以讓你利用來做小量資料的廣播的,要廣播給所有人接收到的資料,並不一定就要放在
SharedObject內,利用其onSync來做同步,有時用send也是一個很簡單的做法,如何定義

  1. 在netStream或SharedObject上定義好method "myfun"
  2. 利用netStream.send("myfun")或sharedobject.send("myfun",myvar)可讓所有client上的"myfun"都會被觸發


四.幾種可能的互動型態範例

  1. Client端對Server端傳送data或呼叫執行Server端function
    應用範例:一個簡易聊天室,聊天內容只存在Server端的變數內,不使用SharedObject存放
    呼叫Server端的message這method來處理client傳上去的msg這對話內容

    Client端:
    nc.call("message", null, msg);
    Server端:
    application.onAppstart=function(){
    application.chat_content="";
    }
    application.onConnect=function(newClient){
    .......
    newClient.message=function(msg){
    application.chat_content+=msg;
    }
    }

  2. Client端對所有Client廣播data並執行指定Client端function
    應用範例:以之前在站上回覆過的問題為例,一個clinet要輸入一個網址url_txt,要讓所有的client都
    會開啟這網址的網頁

    Client端:
    先定義一個附掛在so上的method
    lobby_so.openPage=function(receive_url){
    getURL(receive_url);
    }
    利用send就可讓所有client接收到這網址並開啟
    lobby_so.send("openPage",url_txt);

  3. Server傳送data給特定Client
    應用範例:當有使用者連線上server,當使用者資料驗證正確時,接受其連線一方面要client去執行指定的function跳到某頁或讓某mc出現...,同時又要把server端的資料帶過去
    說明:server只回應正在與server做互動的那個client,如以上範例,server只會去觸發請求連線的該client去執行指定的function,其他client不會有反應

    Server端:
    application.onConnect=function(newClient,pwd){
    if(pwd=="ok"){
    application.acceptConnection(newClient);
    newClient.call("get_message",null,message);
    }else{
    application.rejectConnection(newClient,errObj);
    }
    }
    Client端:
    ........
    nc.get_message=function(message){};

  4. Server廣播data給所有Client
    應用範例:當有人斷線時,由server端廣播所有client,讓所有client都能同步更新client名單
    說明:以上範例來說,當clinet無預警的斷線,只有Server上的application.onDisconnect 這handler會被觸發,也就是說你需要在這handler內寫一些程式去廣播通知給所有的client
    如何廣播?有以下兩種做法

    1. 把資料放在remote SharedObject物件內,只要SO物件內容更動,即自動觸發Client端的so.onSync
      將線上人員名單寫在remote SharedObject物件內,當有人斷線,只要把so內該筆資料剔除掉,因為so內容改變,
      因此所有Client端的so.onSync 這handler將被觸發,即可達到你要更新資料的目的

      Server端
      application.onDisconnect=function(newClient){
      userlist_so.setProperty(newClient.name,"");
      }
      註:相對的當server端無預警的斷線,client端可由nc.onStatus這handler內由判斷info.code 來取得資訊

    2. 當資料不是存在so內時,只是存在server端的一個變數上,可以善加利用application.clients來對所有client廣播
      以下會觸發所有client端上的client_fun,並把server上的sendvar變數帶過去

      server端,
      application.onDisconnect=function(newClient){
      for(var i=0;i<application.clients.length;i++) {<br />
      application.clients[i].call("client_fun",null,sendvar);
      }
      }
      Client端
      nc.client_fun=function(myvar){ }



2005年1月7日 星期五

FCS--Flash Communication Server簡易設定

以下提供在安裝完成Flash Communication Server後,做一些簡易的設定修改,可以讓Server的維護與使用較為便利
一.說明
設定檔均放在C:Program FilesMacromediaFlash Communication Server MXconf目錄下

  1. conf目錄下內建_defaultRoot_目錄,與server.xml檔案
    server.xml內涵括整個server的設定,如設定管理者帳號密碼,在這Server上包含多少Adapter,Adapter有哪些VirtualHost,
    而這些VirtualHost允許哪些帳號使用。
    _defaultRoot_目錄名稱即是預設之Adapter名稱,若你在伺服器上設定多個Adapter,即會有多個目錄,當然你若只是使用個人Developer版本的FCS,是不允許你使用多個Adapter。

  2. 在Adapter目錄(_defaultRoot_)下會有一個內建_defaultVHost_目錄與一個Adaptor.xml檔案
    Adaptor.xml內涵括目前所在Adapter的設定,主要是設定這Adapter內的host要使用哪個ip哪個port來進行連線。當你的Server上有多個Adapter時,每個Adapter間絕對不可同時使用相同ip相同port號,否則會發生衝突,而致系統異常。
    _defaultVHost_目錄名稱即是預設之VirtualHost名稱,當你在這Adapter內設定多個VirtualHost,則需要有多個與所設定VirtualHost同名的目錄存在。

  3. 在VirtualHost目錄(_defaultVHost_)內包含application.xml與vhost.xml兩個檔案
    vhost.xml內設定了包含,這VirtualHost所要使用的application目錄,application.xml內設定了要套用在application的設定。



二.如何增加server管理者帳號?
管理帳號是寫在server.xml內在<admin>往下找會看到<UserList>,server可以有多少管理帳號,就會有幾組的<User></User>。
name放的是使用者帳號,<Password encrypt="true">內是已編碼的的密碼資料,你可以將encrypt設成false,即可直接填入密碼,不做編碼,不過不建議這樣做,可以透過以下兩個方式設定編碼之密碼。

  1. 透過FCS提供之管理介面,在"Admin Users"項目下方加入或修改密碼

  2. 使用Server Management Action Script寫一個管理用的flash檔,利用指令addAdmin(admin_name, password)即可做到,至於Server Management ASD如果你有FCS光碟裡面就有,若無則需要到Macromedia網站下載,FCS Help內並無這份資料。



三.如何指定FCS使用指定IP,指定port
開啟Adaptor.xml,修改<HostPort>192.168.0.2:1935,443,80</HostPort>,使用rtmp連線server時即可將server ip設成192.168.0.2,然後連線會依序找,1935port是否可用,若port 1935被擋,會接下來找port 443,再不行就會走port 80

四.如何指定application所在位置
系統安裝好,application的位置都是預設在C:Program FilesMacromediaFlash Communication Server MXapplications下,也就是說你要連線的ap目錄都要放在這裡,通常這樣的管理是比較不方便的,我會把ap要建置的目錄放在其他好維護的地方
開啟Vhost.xml,找到<AppsDir>填入你放的目錄,以下是我的設定
<AppsDir>d:www_rootfcs_ap</AppsDir>

五.如何設定影音資料的虛擬目錄
如果有預錄好的mp3或flv影片檔要播放,這些要做streaming的多媒體檔案須放在FCS上,而不是在Web Server,可指定較易維護的目錄來放置檔案,並設定虛擬目錄名稱。
開啟Vhost.xml,找到<VirtualDirectory>,內可依需求設定多個stream虛擬目錄,以下我使用兩個目錄分別來放video與audio
<Streams>video;D:www_rootfcs_streamvideo</Streams>
<Streams>audio;D:www_rootfcs_streamaudio</Streams>
將mysong.mp3放到D:www_rootfcs_streamaudio即可在程式內用mystream.play("mp3:audio/mysong")播放