オブジェクト所有権の移譲

目次

概要▲

インスタンス生成されたオブジェクトの所有者が、常に一定とは限らない！

オブジェクトの所有権を「移譲」されるケースを作る

事前設定▲

MonobitViewコンポーネントの「Ownership Transfer」の項目設定が必要です

設定値	反映内容
Fixed	インスタンスの生成から破棄までの間、所有者は固定です。 これがデフォルトの設定であり、この状態では「所有権の移譲」は出来ません。
TakeOver	所有権を取得したい側が RequestOwnership メソッド を実行することによって、自由に所有権を取得することができます。
Request	所有権を取得したい側が RequestOwnership メソッド を実行し、 所有権を移譲する側が OnOwnershipRequest コールバック内で TransferOwnership メソッドを実行することによって、所有権を取得することができます。

MonobitEngine.MonobitView.RequestOwnership メソッド▲

機能

引数

型	変数名	内容
-	-	-

戻り値

型	内容
void	-

付記

設定値	反映内容
Fixed	所有権移譲リクエストを無視します。
TakeOver	所有権が移譲され、呼び出し側が所有権を持ちます。
Request	所有権の移譲リクエストを受けた側の OnOwnershipRequest コールバックを呼び出します。

記述例

/*
 * ボタン入力によって、所有権の移譲をリクエストします。
 * （MonobitView コンポーネントの「Ownership Transfer」の設定値によって、結果が異なります。）
 */
class Foo : MonobitEngine.MonoBehaviour
{
    ...
    
    void OnGUI()
    {
        ...
        
        if( GUILayout.Button( "所有権のリクエスト" ) )
        {
            monobitView.RequestOwnership();
        }
        
        ...
    }
    
    ...
}

MonobitEngine.MonobitView.TransferOwnership メソッド (1)▲

機能

引数

型	変数名	内容
MonobitEngine.MonoBehaviour	newOwner	所有権の移譲先となる、相手プレイヤーを指定します。

戻り値

型	内容
void	-

記述例

/*
 * ボタン入力によって、所有権を強制的にホストに移譲します。
*/
class Foo : MonobitEngine.MonoBehaviour
{
    ...
    
    void OnGUI()
    {
        ...
        
        if( GUILayout.Button( "所有権をホストに" ) )
        {
            monobitView.TransferOwnership( MonobitEngine.MonobitNetwork.host );
        }
        
        ...
    }
    
    ...
}

MonobitEngine.MonobitView.TransferOwnership メソッド (2)▲

機能

引数

型	変数名	内容
int	newOwnerId	所有権の移譲先となる、相手プレイヤーIDを指定します。

戻り値

型	内容
void	-

記述例

/*
 * ボタン入力によって、所有権を強制的に自分自身のものにします。
 */
class Foo : MonobitEngine.MonoBehaviour
{
    ...
    
    void OnGUI()
    {
        ...
        
        if( GUILayout.Button( "所有権を自分自身に" ) )
        {
            monobitView.TransferOwnership( MonobitEngine.MonobitNetwork.player.ID );
        }
        
        ...
    }
    
    ...
}

接続コールバック：OnOwnershipRequest メソッド▲

MonobitView.RequestOwnership により実行されるコールバック

引数

型	変数名	内容
object[]	viewAndPlayer	viewAndPlayer[0] が、所有権の移譲を求めている MonobitView オブジェクト。 viewAndPlayer[1] が、リクエストをしている MonobitPlayer 情報。

戻り値

型	内容
void	-

記述例

/*
 * リクエストしてきた相手がホストだったら、所有権を移譲する
 */
void OnOwnershipRequest( object[] viewAndPlayer )
{
    MonobitView view = viewAndPlayer[0] as MonobitView;
    MonobitPlayer player = viewAndPlayer[1] as MonobitPlayer;

    if( player.isHost )
    {
        view.TransferOwnership( player );
    }
}