LlTeleportAgentGlobalCoords/ja

/ja

/LSL

TeleportAgentGlobalCoords/ja

llTeleportAgentGlobalCoords

要約

関数: llTeleportAgentGlobalCoords( key agent, vector global_coordinates, vector region_coordinates, vector look_at );

?	関数ID
	遅延
	エネルギー

指定した region_coordinates のリージョンの region_coordinates に agent の座標を設定し、テレポートさせます。アバターは到着すると look_at のローカル座標で指定される場所を見るように立ちます。リージョンのグローバル座標は llRequestSimulatorData(region_name, DATA_SIM_POS) を使うと取得できます。

• key	agent	–	同一 地域 にいるアバターの UUID (テレポートするアバター)
• vector	global_coordinates	–	テレポート先のリージョンのグローバル座標。 llRequestSimulatorData(region_name, DATA_SIM_POS) で取得できます。
• vector	region_coordinates	–	テレポート先のリージョン内での着地場所。ローカル座標で指定します。
• vector	look_at	–	テレポートが完了したときにアバターが向く先。ローカル座標で指定します。

実行するには、llRequestPermissions による PERMISSION_TELEPORT 権限がagentから与えられなければなりません。 llRequestSimulatorData と llTeleportAgentGlobalCoords の組み合わせで、リージョンの名前を使ってアバターをテレポートさせることができるようになります。

警告

• 権限の自動付与に頼らないようにしましょう。常に run_time_permissions イベントを使用しましょう。
• スクリプトに PERMISSION_TELEPORT の権限が不足していると、スクリプトはエラーを DEBUG_CHANNEL で叫び、操作に失敗します (しかしスクリプトは処理を続けます)。
• PERMISSION_TELEPORT がagent以外の人から許可され、関数が呼び出されると、 DEBUG_CHANNEL でエラーが叫ばれます。
• いったん PERMISSION_TELEPORT 権限が付与されると、スクリプトの中で (例えば、新しい llRequestPermissions 呼び出しなどにより) 権限をはく奪することができません。スクリプトはオブジェクトが derez (削除、取り外し、取り込み) されない限り権限が失われません。
• llAttachToAvatarTemp で装着されたオブジェクトの中のスクリプトでは、この関数は動作しません。
• この関数でテレポートすることができるのは、オブジェクトのオーナーだけです。
• 座っているアバターをこの関数を使ってテレポートさせることはできません。最初に llUnSit する必要があります。

サンプル

string simName = "Help Island Public";
vector simGlobalCoords;

vector landingPoint = <128.0, 128.0, 24.0>;

key owner;


default
{
    on_rez(integer start_param)
    {
        llResetScript();
    }

    changed(integer change)
    {
        if (change & CHANGED_OWNER)
            llResetScript();
    }

    state_entry()
    {
        owner = llGetOwner();

        llRequestPermissions(owner, PERMISSION_TELEPORT);
        llRequestSimulatorData(simName, DATA_SIM_POS);
    }

    touch_start(integer total_number)
    {
        key id = llDetectedKey(0);

        if (id == owner)
        {
            if (simGlobalCoords == ZERO_VECTOR)
            {
                llOwnerSay("設定エラー。TPのリクエストが却下されました。再度実行してください！");
                llResetScript();
            }
            else
            {
                llOwnerSay("テレポート先: http://maps.secondlife.com/secondlife/"
                    + llEscapeURL(simName) + "/" + (string)llRound(landingPoint.x)
                    + "/" + (string)llRound(landingPoint.y) + "/" + (string)llRound(landingPoint.z) + "/");

                llTeleportAgentGlobalCoords(owner, simGlobalCoords, landingPoint, ZERO_VECTOR);
            }
        }
        else
        {
            // llRegionSayTo は llInstantMessage よりも動作が軽快です。
            // また、アバターは同一 SIM に存在するとみなして大丈夫です。

            llRegionSayTo(id, PUBLIC_CHANNEL,
                "ごめんなさい。オブジェクトの所有者でない方をテレポートさせることはできません。");
        }
    }

    run_time_permissions(integer perm)
    {
        // パーミッションの申請が却下された場合 (! は NOT の意味)
        if (!(perm & PERMISSION_TELEPORT))
        {
            llOwnerSay("テレポートするには、承認してもらう必要があります。");
            llRequestPermissions(owner, PERMISSION_TELEPORT);
        }
    }

//  dataserver イベントは、データが戻ってきた場合にのみ呼ばれます。
//  つまり、このイベントが存在しない SIM にデータをリクエストした場合、
// このイベントが呼ばれることはありません。

    dataserver(key query_id, string data)
    {
        simGlobalCoords = (vector)data;
        // llOwnerSay("SIM のグローバル座標: " + (string)simGlobalCoords);
    }
}

関連項目

イベント

•

run_time_permissions

–

権限取得イベント

関数

•	llGetPermissions	–	付与されている権限を取得します
•	llGetPermissionsKey	–	権限を許可したエージェントを取得します
•	llRequestPermissions	–	権限を要求します
•	llRequestSimulatorData	–	SIM の位置を取得するのに便利な関数
•	llTeleportAgent	–	SIM内でのエージェントのテレポート

記事

•

権限/スクリプト

特記事項

Search JIRA for related Issues

Signature
function void llTeleportAgentGlobalCoords( key agent, vector global_coordinates, vector region_coordinates, vector look_at );

この翻訳は 原文 と比べて古いですか？間違いがありますか？読みにくいですか？みんなで 修正 していきましょう！ (手順はこちら)

この項目はあなたにとって参考にならない項目ですか？もしかしたらLSL Wikiの関連した項目が参考になるかもしれません。