LlSitOnLink/ja

/ja

/LSL

SitOnLink/ja

llSitOnLink

要約

関数: Integer llSitOnLink( key agent_id, integer link );

?	関数ID
	遅延
	エネルギー

The avatar specified by agent_id is forced to sit on the sit target of the prim indicated by the link parameter. If the specified link is already occupied, the simulator searches down the chain of prims in the link set looking for an available sit target.
Integer で返します。

• key	agent_id	–	UUID of the avatar being forced to sit
• integer	link	–	Link number for the prim containing the desired sit target

If successful, this method returns 1.

If the function fails, it returns a negative number constant.

Link constants that indicate a single prim may be used for the link parameter. These are LINK_ROOT and LINK_THIS. Other constants such as LINK_SET, LINK_CHILDREN, LINK_ALL_OTHERS will return an INVALID_LINK error.

This method must be called from an experience enabled script running on land that has enabled the experience key. If these conditions are not met this method returns a NOT_EXPERIENCE error.

The targeted avatar must also have accepted the experience. If the user is not participating in the experience this method returns NO_EXPERIENCE_PERMISSION. If the avatar id can not be found or is not over land that has enabled the experience this method returns INVALID_AGENT.

If there are no valid sit targets remaining in the linkset this method returns NO_SIT_TARGET and no action is taken with the avatar.

If the avatar does not have access to the parcel containing the prim running this script, this call fails.

Constant	Value	Description
SIT_NOT_EXPERIENCE	-1	The script is not running as part of an experience with a valid experience key or the experience is not allowed at your location.
SIT_NO_EXPERIENCE_PERMISSION	-2	The agent has not granted permission.
SIT_NO_SIT_TARGET	-3	Unable to find an open sit target.
SIT_INVALID_AGENT	-4	Unable to find specified agent.
SIT_INVALID_LINK	-5	Unable to find specified link or the link constant would return multiple prims.
SIT_NO_ACCESS	-6	The avatar does not have access to the parcel that the prim running this script is located in.
SIT_INVALID_OBJECT	-7	This value is returned if the llSitOnLink is trying to force the user to sit on something that cannot be sat upon (such as an attachment).

サンプル

integer gLinkId = LINK_THIS;

default
{
    touch_start(integer total_number)
    {
        llRequestExperiencePermissions(llDetectedKey(0), "");
    }

    experience_permissions(key agent_id)
    {
        integer sitTest = llSitOnLink(agent_id, gLinkId);
        if (sitTest != 1)
        {
            llInstantMessage(agent_id, "Cannot force agent " + (string)agent_id + " to sit due to reason id: " + (string)sitTest);
        }
    }

    experience_permissions_denied(key agent_id, integer reason)
    {
        llInstantMessage(agent_id, "Denied experience permissions for " + (string)agent_id + " due to reason id: " + (string)reason);
    }
}

注意点

This function was introduced in conjunction with new primitive parameter constants: PRIM_ALLOW_UNSIT, PRIM_SCRIPTED_SITS_ONLY, and PRIM_SIT_TARGET.

関連項目

関数

• llLinkSitTarget/ja
• llSitTarget/ja
• llSetSitText/ja
• llAvatarOnLinkSitTarget/ja
• llAvatarOnSitTarget/ja
• llUnSit/ja

Constants

• PRIM_ALLOW_UNSIT
• PRIM_SCRIPTED_SIT_ONLY
• PRIM_SIT_TARGET

特記事項

All Issues

~ Search JIRA for related Issues

BUG-40739

Redesign llSitOnLink() to use the permissions system

Signature
function Integer llSitOnLink( key agent_id, integer link );

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

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