Files
node-metaverse/lib/Bot.ts
Casper Warden da4cd459f1 - Add "GET" method to Caps
- New events: ObjectPhysicsDataEvent, ParcelPropertiesEvent, NewObjectEvent, ObjectUpdateEvent, ObjectKilledEvent
- Added getXML function to Color4, Vector2, Vector3, Vector4, GameObject, Region, Quaternion, UUID for opensim-compatible XML export
- Added TextureAnim and ParticleSystem decoding to the "full" ObjectStore
- Object store will automatically request missing "parent" prims
- "setPersist" - When persist is TRUE, the ObjectStore will not forget about "killed" prims - useful for region scanning
- Support for Flexible params, Light params, LightImage params, Mesh data, Sculpt maps
- Fixed object scale being incorrectly calculated
- Add terrain decoding (this was a ballache)
- Add parcel map decoding
- Add support for region windlight settings (region.environment)
- Add support for materials (normal / specular maps)
- Add getBuffer, getLong and bitwiseOr to UUID
- Added a circular-reference-safe JSONStringify to Utils
- Add XferFile capability to Circuit

PUBLIC API:

AssetCommands:
- Rework "downloadAsset" to detect failures
- NEW: downloadInventoryAsset() - uses TransferRequest for prim inventory items
- NEW: getMaterials() - resolves material UUIDs

RegionCommands:
- NEW: getTerrainTextures()
- NEW: exportSettings() - OpenSim XML export of region settings
- NEW: async getTerrain() - Get binary terrain heightmap, 256x256 float32
- resolveObjects() - now fetches task inventory contents too.
- resolveObjects() - fix calculation of land impact
- NEW: getObjectByLocalID(localID: number, timeout: number)
- NEW: getObjectByUUID(uuid: UUID, timeout: number)
- NEW: getParcels();
- NEW: pruneObjects - removes missing GameObjects from a list
- NEW: setPersist - prevent objectstore from forgetting about killed gameobjects
2018-10-31 11:28:24 +00:00

436 lines
16 KiB
TypeScript

import {LoginHandler} from './LoginHandler';
import {LoginResponse} from './classes/LoginResponse';
import {LoginParameters} from './classes/LoginParameters';
import {Agent} from './classes/Agent';
import {PacketFlags} from './enums/PacketFlags';
import {UseCircuitCodeMessage} from './classes/messages/UseCircuitCode';
import {CompleteAgentMovementMessage} from './classes/messages/CompleteAgentMovement';
import {Message} from './enums/Message';
import {Packet} from './classes/Packet';
import {Region} from './classes/Region';
import {LogoutRequestMessage} from './classes/messages/LogoutRequest';
import {Utils} from './classes/Utils';
import {RegionHandshakeReplyMessage} from './classes/messages/RegionHandshakeReply';
import {RegionProtocolFlags} from './enums/RegionProtocolFlags';
import {AgentDataUpdateRequestMessage} from './classes/messages/AgentDataUpdateRequest';
import {TeleportProgressMessage} from './classes/messages/TeleportProgress';
import {TeleportStartMessage} from './classes/messages/TeleportStart';
import {TeleportEvent} from './events/TeleportEvent';
import {ClientEvents} from './classes/ClientEvents';
import {TeleportEventType} from './enums/TeleportEventType';
import {ClientCommands} from './classes/ClientCommands';
import {DisconnectEvent} from './events/DisconnectEvent';
import {KickUserMessage} from './classes/messages/KickUser';
import {StartPingCheckMessage} from './classes/messages/StartPingCheck';
import {CompletePingCheckMessage} from './classes/messages/CompletePingCheck';
import Timer = NodeJS.Timer;
import {BotOptionFlags} from './enums/BotOptionFlags';
import {FilterResponse} from './enums/FilterResponse';
import {LogoutReplyMessage} from './classes/messages/LogoutReply';
import {EventQueueStateChangeEvent} from './events/EventQueueStateChangeEvent';
import {UUID} from './classes/UUID';
import {Vector3} from './classes/Vector3';
import {RegionHandshakeMessage} from './classes/messages/RegionHandshake';
import {AgentMovementCompleteMessage} from './classes/messages/AgentMovementComplete';
import {Subscription} from 'rxjs/internal/Subscription';
import Long = require('long');
export class Bot
{
private loginParams: LoginParameters;
private currentRegion: Region;
private agent: Agent;
private ping: Timer | null = null;
private pingNumber = 0;
private lastSuccessfulPing = 0;
private circuitSubscription: Subscription | null = null;
private options: BotOptionFlags;
private eventQueueRunning = false;
public clientEvents: ClientEvents;
public clientCommands: ClientCommands;
private eventQueueWaits: any = {};
private stay = false;
private stayRegion = '';
private stayPosition = new Vector3();
constructor(login: LoginParameters, options: BotOptionFlags)
{
this.clientEvents = new ClientEvents();
this.loginParams = login;
this.options = options;
this.clientEvents.onEventQueueStateChange.subscribe((evt: EventQueueStateChangeEvent) =>
{
this.eventQueueRunning = evt.active;
for (const waitID of Object.keys(this.eventQueueWaits))
{
try
{
clearTimeout(this.eventQueueWaits[waitID].timer);
this.eventQueueWaits[waitID].resolve();
delete this.eventQueueWaits[waitID];
}
catch (ignore){}
}
});
}
stayPut(stay: boolean, regionName?: string, position?: Vector3)
{
this.stay = stay;
if (regionName !== undefined && position !== undefined)
{
this.stayRegion = regionName;
this.stayPosition = position;
}
}
async login()
{
const loginHandler = new LoginHandler(this.clientEvents, this.options);
const response: LoginResponse = await loginHandler.Login(this.loginParams);
this.currentRegion = response.region;
this.agent = response.agent;
this.clientCommands = new ClientCommands(response.region, response.agent, this);
return response;
}
async changeRegion(region: Region, requested: boolean)
{
this.closeCircuit();
this.currentRegion = region;
this.clientCommands = new ClientCommands(this.currentRegion, this.agent, this);
if (this.ping !== null)
{
clearInterval(this.ping);
this.ping = null;
}
await this.connectToSim(requested);
}
waitForEventQueue(timeout: number = 1000): Promise<void>
{
return new Promise((resolve, reject) =>
{
if (this.eventQueueRunning)
{
resolve();
}
else
{
const waitID = UUID.random().toString();
const newWait: {
'resolve': any,
'timer'?: Timer
} = {
'resolve': resolve
};
newWait.timer = setTimeout(() =>
{
delete this.eventQueueWaits[waitID];
reject(new Error('Timeout'));
}, timeout);
this.eventQueueWaits[waitID] = newWait;
}
});
}
private closeCircuit()
{
this.currentRegion.shutdown();
if (this.circuitSubscription !== null)
{
this.circuitSubscription.unsubscribe();
this.circuitSubscription = null;
}
delete this.currentRegion;
this.clientCommands.shutdown();
delete this.clientCommands;
if (this.ping !== null)
{
clearInterval(this.ping);
this.ping = null;
}
}
private kicked(message: string)
{
this.closeCircuit();
this.agent.shutdown();
delete this.agent;
this.disconnected(false, message);
}
private disconnected(requested: boolean, message: string)
{
const disconnectEvent = new DisconnectEvent();
disconnectEvent.requested = requested;
disconnectEvent.message = message;
if (this.clientEvents)
{
this.clientEvents.onDisconnected.next(disconnectEvent);
}
}
async close()
{
const circuit = this.currentRegion.circuit;
const msg: LogoutRequestMessage = new LogoutRequestMessage();
msg.AgentData = {
AgentID: this.agent.agentID,
SessionID: circuit.sessionID
};
circuit.sendMessage(msg, PacketFlags.Reliable);
await circuit.waitForMessage<LogoutReplyMessage>(Message.LogoutReply, 5000);
this.stayRegion = '';
this.stayPosition = new Vector3();
this.closeCircuit();
this.agent.shutdown();
delete this.agent;
this.disconnected(true, 'Logout completed');
}
agentID(): UUID
{
return this.agent.agentID;
}
async connectToSim(requested: boolean = true)
{
this.agent.setCurrentRegion(this.currentRegion);
const circuit = this.currentRegion.circuit;
circuit.init();
const msg: UseCircuitCodeMessage = new UseCircuitCodeMessage();
msg.CircuitCode = {
SessionID: circuit.sessionID,
ID: this.agent.agentID,
Code: circuit.circuitCode
};
await circuit.waitForAck(circuit.sendMessage(msg, PacketFlags.Reliable), 1000);
const agentMovement: CompleteAgentMovementMessage = new CompleteAgentMovementMessage();
agentMovement.AgentData = {
AgentID: this.agent.agentID,
SessionID: circuit.sessionID,
CircuitCode: circuit.circuitCode
};
circuit.sendMessage(agentMovement, PacketFlags.Reliable);
let agentPosition: Vector3 | null = null;
let regionName: string | null = null;
circuit.waitForMessage<AgentMovementCompleteMessage>(Message.AgentMovementComplete, 10000).then((agentMovementMsg: AgentMovementCompleteMessage) =>
{
agentPosition = agentMovementMsg.Data.Position;
if (regionName !== null)
{
if (this.stayRegion === '' || requested)
{
this.stayPut(this.stay, regionName, agentPosition);
}
}
}).catch(() =>
{
console.error('Timed out waiting for AgentMovementComplete')
});
const handshakeMessage = await circuit.waitForMessage<RegionHandshakeMessage>(Message.RegionHandshake, 10000);
const handshakeReply: RegionHandshakeReplyMessage = new RegionHandshakeReplyMessage();
handshakeReply.AgentData = {
AgentID: this.agent.agentID,
SessionID: circuit.sessionID
};
handshakeReply.RegionInfo = {
Flags: RegionProtocolFlags.SelfAppearanceSupport | RegionProtocolFlags.AgentAppearanceService
};
await circuit.waitForAck(circuit.sendMessage(handshakeReply, PacketFlags.Reliable), 10000);
this.currentRegion.handshake(handshakeMessage).then(() =>
{
regionName = this.currentRegion.regionName;
console.log('Arrived in region: ' + regionName);
if (agentPosition !== null)
{
if (this.stayRegion === '' || requested)
{
this.stayPut(this.stay, regionName, agentPosition);
}
}
}).catch((error) =>
{
console.error('Timed out getting handshake');
console.error(error);
});
if (this.clientCommands !== null)
{
this.clientCommands.network.setBandwidth(1536000);
}
const agentRequest = new AgentDataUpdateRequestMessage();
agentRequest.AgentData = {
AgentID: this.agent.agentID,
SessionID: circuit.sessionID
};
circuit.sendMessage(agentRequest, PacketFlags.Reliable);
this.agent.setInitialAppearance();
this.agent.circuitActive();
this.lastSuccessfulPing = new Date().getTime();
this.ping = setInterval(async () =>
{
this.pingNumber++;
if (this.pingNumber % 12 === 0 && this.stay)
{
if (this.currentRegion.regionName !== this.stayRegion)
{
console.log('Stay Put: Attempting to teleport to ' + this.stayRegion);
this.clientCommands.teleport.teleportTo(this.stayRegion, this.stayPosition, this.stayPosition).then(() =>
{
console.log('I found my way home.');
}).catch(() =>
{
console.log('Cannot teleport home right now.');
});
}
}
if (this.pingNumber > 255)
{
this.pingNumber = 0;
}
const ping = new StartPingCheckMessage();
ping.PingID = {
PingID: this.pingNumber,
OldestUnacked: this.currentRegion.circuit.getOldestUnacked()
};
circuit.sendMessage(ping, PacketFlags.Reliable);
circuit.waitForMessage<CompletePingCheckMessage>(Message.CompletePingCheck, 10000, ((pingData: {
pingID: number,
timeSent: number
}, cpc: CompletePingCheckMessage): FilterResponse =>
{
if (cpc.PingID.PingID === pingData.pingID)
{
this.lastSuccessfulPing = new Date().getTime();
const pingTime = this.lastSuccessfulPing - pingData.timeSent;
if (this.clientEvents !== null)
{
this.clientEvents.onCircuitLatency.next(pingTime);
}
return FilterResponse.Finish;
}
return FilterResponse.NoMatch;
}).bind(this, {
pingID: this.pingNumber,
timeSent: new Date().getTime()
})).then(() =>
{
// No action needed
}).catch(() =>
{
console.error('Timeout waiting for ping from the simulator - possible disconnection')
});
if ((new Date().getTime() - this.lastSuccessfulPing) > 60000)
{
// We're dead, jim
this.kicked('Circuit Timeout');
}
}, 5000);
this.circuitSubscription = circuit.subscribeToMessages(
[
Message.TeleportFailed,
Message.TeleportFinish,
Message.TeleportLocal,
Message.TeleportStart,
Message.TeleportProgress,
Message.TeleportCancel,
Message.KickUser
], (packet: Packet) =>
{
switch (packet.message.id)
{
case Message.TeleportLocal:
{
const tpEvent = new TeleportEvent();
tpEvent.message = '';
tpEvent.eventType = TeleportEventType.TeleportCompleted;
tpEvent.simIP = 'local';
tpEvent.simPort = 0;
tpEvent.seedCapability = '';
if (this.clientEvents === null)
{
this.kicked('ClientEvents is null');
}
this.clientEvents.onTeleportEvent.next(tpEvent);
break;
}
case Message.TeleportStart:
{
const teleportStart = packet.message as TeleportStartMessage;
const tpEvent = new TeleportEvent();
tpEvent.message = '';
tpEvent.eventType = TeleportEventType.TeleportStarted;
tpEvent.simIP = '';
tpEvent.simPort = 0;
tpEvent.seedCapability = '';
if (this.clientEvents === null)
{
this.kicked('ClientEvents is null');
}
this.clientEvents.onTeleportEvent.next(tpEvent);
break;
}
case Message.TeleportProgress:
{
const teleportProgress = packet.message as TeleportProgressMessage;
const message = Utils.BufferToStringSimple(teleportProgress.Info.Message);
const tpEvent = new TeleportEvent();
tpEvent.message = message;
tpEvent.eventType = TeleportEventType.TeleportProgress;
tpEvent.simIP = '';
tpEvent.simPort = 0;
tpEvent.seedCapability = '';
if (this.clientEvents === null)
{
this.kicked('ClientEvents is null');
}
this.clientEvents.onTeleportEvent.next(tpEvent);
break;
}
case Message.KickUser:
{
const kickUser = packet.message as KickUserMessage;
this.kicked(Utils.BufferToStringSimple(kickUser.UserInfo.Reason));
break;
}
}
});
}
}