关于
内向缓冲器默认为3个服务器帧长(刑警组织在4个快照之间). 所以,如果 潜伏是50米 和一个 服务器框架为 50ms内向缓冲器有200多米长.
如果你有兴趣多了解一点"快照"的内幕 这个视频。 。 。 .
特征
- 轻松添加 客户端预测 财务报告和审定财务报表 服务器对齐。 。 。 .
- 轻松添加 损失补偿。 。 。 .
- 轻松 压缩/编码 发送/接收前的快照.
导言
看看这些YouTube视频:
游戏示例
这个 github 仓库 包含一个很好的例子。 看看这个!
# clone the repo
$ git clone https://github.com/geckosio/snapshot-interpolation.git
# cd into it
$ cd snapshot-interpolation
# install all dependencies
$ npm install
# start the example
$ npm start
# play in your browser
http://localhost:8080/
安装
从 npm 安装 .
npm install @geckos.io/snapshot-interpolation
或使用捆绑版.
<script src="https://unpkg.com/@geckos.io/[email protected]/bundle/snapshot-interpolation.js"></script>
<script>
const { SnapshotInterpolation, Vault } = Snap
</script>
如何使用
服务器.js
// import @geckos.io/snapshot-interpolation
import { SnapshotInterpolation } from '@geckos.io/snapshot-interpolation'
// initialize the library
const SI = new SnapshotInterpolation()
// your server update loop
update() {
// create a snapshot of the current world
const snapshot = SI.snapshot.create(worldState)
// add the snapshot to the vault in case you want to access it later (optional)
SI.vault.add(snapshot)
// send the snapshot to the client (using geckos.io or any other library)
this.emit('update', snapshot)
}
客户端.js
// import @geckos.io/snapshot-interpolation
import { SnapshotInterpolation } from '@geckos.io/snapshot-interpolation'
// initialize the library (add your server's fps)
const SI = new SnapshotInterpolation(serverFPS)
// when receiving the snapshot on the client
this.on('update', (snapshot) => {
// read the snapshot
SI.snapshot.add(snapshot)
}
// your client update loop
update() {
// calculate the interpolation for the parameters x and y and return the snapshot
const snapshot = SI.calcInterpolation('x y') // [deep: string] as optional second parameter
// access your state
const { state } = snapshot
// apply the interpolated values to you game objects
const { id, x, y } = state[0]
if (hero.id === id) {
hero.x = x
hero.y = y
}
}
世界状况
世界国必须是一个有非巢穴物体(Quaternion除外)的阵列. 你可以随心所欲地给你取名 度值、弧度值或四角值加 key(deg), (中文(简体) ), key(rad) 或者说 key(quat)。 。 。 .
线性内插
// the worldState on the server
const worldState = [
{ id: 'heroBlue', x: 23, y: 14, z: 47 },
{ id: 'heroRed', x: 23, y: 14, z: 47 },
{ id: 'heroGreen', x: 23, y: 14, z: 47 }
]
// calc interpolation on the client
SI.calcInterpolation('x y z')
学位、放射性和定性
// the worldState on the server
const worldState = [
{
id: 'myHero',
direction: Math.PI / 2,
rotationInDeg: 90,
q: { x: 0, y: 0.707, z: 0, w: 0.707 }
}
]
// calc interpolation on the client
SI.calcInterpolation('direction(rad) rotationInDeg(deg) q(quat)')
多个国家
// the players state
const playersState = [
{ id: 0, x: 65, y: -17 },
{ id: 1, x: 32, y: 9 }
]
// the towers state
const towersState = [
{ id: 0, health: 100, type: 'blizzardCannon' },
{ id: 1, health: 89, type: 'flameThrower' }
]
const worldState = {
players: playersState,
towers: towersState
}
// create snapshot
SI.snapshot.create(worldState)
// we only want to interpolate x and y on the players object
SI.calcInterpolation('x y', 'players')
默认
断层挡住你所有的快照 每个快照Poltocation实例都包含一个"断层",但如果需要,您可以轻松创建更多:
import { Vault } from '@geckos.io/snapshot-interpolation'
const customVault = new Vault()
压缩
您可以使用软件包 @geckos 在将快照发送给客户端之前先压缩快照.
// schema.js
const playerSchema = BufferSchema.schema('player', {
id: uint8,
x: { type: int16, digits: 1 },
y: { type: int16, digits: 1 }
})
const snapshotSchema = BufferSchema.schema('snapshot', {
id: { type: string8, length: 6 },
time: uint64,
state: { players: [playerSchema] }
})
export const snapshotModel = new Model(snapshotSchema)
// server.js
const snapshot = SI.snapshot.create({
players: [
{ id: 0, x: 17.5, y: -1.1 },
{ id: 1, x: 5.8, y: 18.9 }
]
})
const buffer = snapshotModel.toBuffer(snapshot)
send(buffer)
// client.js
receive(buffer => {
snapshot = snapshotModel.fromBuffer(buffer)
SI.addSnapshot(snapshot)
})
API 密码
这看起来非常TypeScriptisch, 但你当然也可以在JavaScript中使用.
// import
import { SnapshotInterpolation, Vault, Types } from '@geckos.io/snapshot-interpolation'
// types
type Value = number | string | Quat | undefined
type ID = string
type Time = number
type State = Entity[]
type Quat = { x: number; y: number; z: number; w: number }
// interfaces
export interface Entity {
id: string
[key: string]: Value
}
export interface Snapshot {
id: ID
time: Time
state: State | { [key: string]: State }
}
export interface InterpolatedSnapshot {
state: State
percentage: number
older: ID
newer: ID
}
// static methods
/** Create a new Snapshot */
SnapshotInterpolation.CreateSnapshot(state: State): Snapshot
/** Create a new ID */
SnapshotInterpolation.NewId(): string
/** Get the current time in milliseconds. */
SnapshotInterpolation.Now(): number
// class SnapshotInterpolation
const SI = new SnapshotInterpolation(serverFPS?: number)
/** Access the vault. */
SI.vault: Vault
/** Get the Interpolation Buffer time in milliseconds. */
SI.interpolationBuffer.get(): number
/** Set the Interpolation Buffer time in milliseconds. */
SI.interpolationBuffer.set(milliseconds: number): void
/** Create the snapshot on the server. */
SI.snapshot.create(state: State): Snapshot
/** Add the snapshot you received from the server to automatically calculate the interpolation with calcInterpolation() */
SI.snapshot.add(snapshot: Snapshot): void
/** Interpolate between two snapshots give the percentage or time. */
SI.interpolate(snapshotA: Snapshot, snapshotB: Snapshot, timeOrPercentage: number, parameters: string, deep: string): InterpolatedSnapshot
/** Get the calculated interpolation on the client. */
SI.calcInterpolation(parameters: string, deep: string): InterpolatedSnapshot | undefined
// class Vault
const vault = new Vault()
/** Get a Snapshot by its ID. */
vault.getById(id: ID): Snapshot
/** Get the latest snapshot */
vault.get(): Snapshot | undefined;
/** Get the two snapshots around a specific time */
vault.get(time: number): { older: Snapshot; newer: Snapshot; } | undefined
/** Get the closest snapshot to e specific time */
vault.get(time: number, closest: boolean): Snapshot | undefined
/** Add a snapshot to the vault. */
vault.add(snapshot: Snapshot): void
/** Get the current capacity (size) of the vault. */
vault.size(): number
/** Set the max capacity (size) of the vault. */
vault.setMaxSize(size: number): void
/** Get the max capacity (size) of the vault. */
vault.getMaxSize(): number