PathfindingService
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
PathfindingService は、2つのポイント間のロジカルなパスを見つけるために使用されます。これにより、キャラクターが壁や他の障害物に遭遇せずにポイント間を移動できます。デフォルトでは、最も短いパスが計算されますが、壁や他の障害物を回避するためのパスファインダーを実装して、さまざまな素材、周囲
詳細は、「キャラクターパスファインディング」を参照してください。
概要
方法
指定された 2つのポイントの間で Path を見つけます。
プロパティ
方法
CreatePath
さまざまなエージェントパスラメータに基づく Class.Path オブジェクトを作成します。 agentParameters テーブルの有効なキーと値は次のとおりです：
| キー | タイプ | デフォルト | 説明 |
|---|
パラメータ
サイズのエージェント (パスを沿って移動するヒューマノイド) のサイズを微調整できる Lua テーブル。上の例で、有効なキー、タイプ、および説明を参照してください。
戻り値
コードサンプル
local Workspace = game:GetService("Workspace")
local PathfindingService = game:GetService("PathfindingService")
-- This model contains a start, end and three paths between the player can walk on: Snow, Metal and LeafyGrass
local PathOptionsModel = script.Parent.PathOptions
local startPosition = PathOptionsModel.Start.Position
local finishPosition = PathOptionsModel.End.Position
-- Create a path that avoids Snow and Metal materials
-- This will ensure the path created avoids the Snow and Metal paths and guides
-- the user towards the LeafyGrass path
local path = PathfindingService:CreatePath({
AgentRadius = 3,
AgentHeight = 6,
AgentCanJump = false,
Costs = {
Snow = math.huge,
Metal = math.huge,
},
})
-- Compute the path
local success, errorMessage = pcall(function()
path:ComputeAsync(startPosition, finishPosition)
end)
-- Confirm the computation was successful
if success and path.Status == Enum.PathStatus.Success then
-- For each waypoint, create a part to visualize the path
for _, waypoint in path:GetWaypoints() do
local part = Instance.new("Part")
part.Position = waypoint.Position
part.Size = Vector3.new(0.5, 0.5, 0.5)
part.Color = Color3.new(1, 0, 1)
part.Anchored = true
part.CanCollide = false
part.Parent = Workspace
end
else
print(`Path unable to be computed, error: {errorMessage}`)
end
FindPathAsync
この関数は、Path を 2つの指定されたポイント間で見つけます。このパスは、PathfindingService によって作成されたナビゲーショングリッドを使用し、通常サイズの Roblox キャラクターがパスをフォローできるようにします。
この関数は、Path オブジェクトを返します。このオブジェクトには、パスの座標が含まれています。2つのポイント間でパスが見つからない場合、この関数はまだ Path オブジェクトを返しますが、そのオブジェクトの Path.Status は 2>En
Class.Path オブジェクトのウェイポイントを取得するには、Path:GetWaypoints() 関数を使用できます。