ObjectLauncher Class

​

 @Component
 export default class Example_ObjectLauncher_OnHomingFail extends Script {

     protected async onStart(): Promise<void> {

         // 下列逻辑在服务端执行
         if(SystemUtil.isServer()) {
             // 在世界坐标（200，0，25）异步生成一个球
             let ball = await GameObject.asyncSpawn("84121") as Model;
             ball.worldTransform.position = new Vector(200, 0, 25);

             // 在世界坐标（2000，1000，130）异步生成一个NPC,2s后销毁。
             let target = Player.spawnDefaultCharacter();
             target.worldTransform.position = new Vector(2000, 1000, 130);

             // 异步生成对象发射器
             let myLauncher = await GameObject.asyncSpawn("ObjectLauncher") as ObjectLauncher;

             // 设置发射初始速度为1000
             myLauncher.initialSpeed = 1000;
             // 设置碰撞半径为25
             myLauncher.capsuleRadius = 25;
             // 设置碰撞半长为25
             myLauncher.capsuleHalfLength = 25;
             // 开启反弹
             myLauncher.isShouldBounce = true;
             // 设置碰撞速度衰减为0.5
             myLauncher.collisionVelocityRetention = 0.5;

             // 给发射器追踪失败委托绑定函数，追踪失败时打印信息
             myLauncher.onProjectileHomingFail.add((projectile) => {
                 console.log("Homing Fail");
             });

             // 添加客户端发送的”LAUNCHTOTARGET“事件监听器，将球朝斜上方发射并追踪NPC。
             Event.addClientListener("LAUNCHTOTARGET", () => {
                 TimeUtil.delaySecond(1).then(() => {
                     target.destroy();
                  });
                 myLauncher.spawnProjectileInstanceLaunchToTarget(ball.gameObjectId, target, 2000, ball.worldTransform.position, new Vector(1, 0, 1));
             });
         }

         // 下列逻辑在客户端执行
         if(SystemUtil.isClient()) {
             // 添加一个按键方法：按下按键”1“，向服务端派送一个”LAUNCHTOTARGET“事件，发射一个球追踪NPC。
             InputUtil.onKeyDown(Keys.One, () => {
                 Event.dispatchToServer("LAUNCHTOTARGET");
             });
         }
     }
 }

 @Component
 export default class Example_ObjectLauncher_OnHomingFail extends Script {

     protected async onStart(): Promise<void> {

         // 下列逻辑在服务端执行
         if(SystemUtil.isServer()) {
             // 在世界坐标（200，0，25）异步生成一个球
             let ball = await GameObject.asyncSpawn("84121") as Model;
             ball.worldTransform.position = new Vector(200, 0, 25);

             // 在世界坐标（2000，1000，130）异步生成一个NPC,2s后销毁。
             let target = Player.spawnDefaultCharacter();
             target.worldTransform.position = new Vector(2000, 1000, 130);

             // 异步生成对象发射器
             let myLauncher = await GameObject.asyncSpawn("ObjectLauncher") as ObjectLauncher;

             // 设置发射初始速度为1000
             myLauncher.initialSpeed = 1000;
             // 设置碰撞半径为25
             myLauncher.capsuleRadius = 25;
             // 设置碰撞半长为25
             myLauncher.capsuleHalfLength = 25;
             // 开启反弹
             myLauncher.isShouldBounce = true;
             // 设置碰撞速度衰减为0.5
             myLauncher.collisionVelocityRetention = 0.5;

             // 给发射器追踪失败委托绑定函数，追踪失败时打印信息
             myLauncher.onProjectileHomingFail.add((projectile) => {
                 console.log("Homing Fail");
             });

             // 添加客户端发送的”LAUNCHTOTARGET“事件监听器，将球朝斜上方发射并追踪NPC。
             Event.addClientListener("LAUNCHTOTARGET", () => {
                 TimeUtil.delaySecond(1).then(() => {
                     target.destroy();
                  });
                 myLauncher.spawnProjectileInstanceLaunchToTarget(ball.gameObjectId, target, 2000, ball.worldTransform.position, new Vector(1, 0, 1));
             });
         }

         // 下列逻辑在客户端执行
         if(SystemUtil.isClient()) {
             // 添加一个按键方法：按下按键”1“，向服务端派送一个”LAUNCHTOTARGET“事件，发射一个球追踪NPC。
             InputUtil.onKeyDown(Keys.One, () => {
                 Event.dispatchToServer("LAUNCHTOTARGET");
             });
         }
     }
 }

@Component
 export default class Example_ObjectLauncher_Acceleration extends Script {

     protected async onStart(): Promise<void> {

         // 下列逻辑在服务端执行
         if(SystemUtil.isServer()) {
             // 在世界坐标（200，0，25）异步生成一个火箭
             let rocket = await GameObject.asyncSpawn("162807") as Model;
             rocket.worldTransform.position = new Vector(2000, 0, 25);

             // 异步生成对象发射器
             let myLauncher = await GameObject.asyncSpawn("ObjectLauncher") as ObjectLauncher;

             // 设置发射初始速度为1
             myLauncher.initialSpeed = 1;
             // 设置发射最大速度为1000
             myLauncher.maxSpeed = 1000;
             // 设置发射加速度为200
             myLauncher.acceleration = 200;
             // 设置碰撞半径为25
             myLauncher.capsuleRadius = 25;
             // 设置碰撞半长为25
             myLauncher.capsuleHalfLength = 25;
             // 开启反弹
             myLauncher.isShouldBounce = true;
             // 设置重力缩放为0
             myLauncher.gravityScale = 0;
             // 设置旋转不跟随速度方向
             myLauncher.isRotationFollowsVelocity = false;
             // 运动时间为10s
             myLauncher.lifeSpan = 10;

             // 添加客户端发送的”LAUNCH“事件监听器，将火箭朝上方发射。
             Event.addClientListener("LAUNCH", () => {
                 myLauncher.spawnProjectileInstanceLaunch(rocket.gameObjectId, rocket.worldTransform.position, new Vector(0, 0, 1));
                 rocket.localTransform.rotation = new Rotation(0, 90, 0);
             });
         }

         // 下列逻辑在客户端执行
         if(SystemUtil.isClient()) {
             // 添加一个按键方法：按下按键”1“，向服务端派送一个”LAUNCH“事件，发射一个球。
             InputUtil.onKeyDown(Keys.One, () => {
                 Event.dispatchToServer("LAUNCH");
             });
         }
     }
 }

___

### spawnProjectileInstanceLaunchToTarget <Score text="spawnProjectileInstanceLaunchToTarget" /> 

• **spawnProjectileInstanceLaunchToTarget**(`childObjectId`, `target`, `targetingAcceleration?`, `startPosition?`, `direction?`, `isAllClientLaunch?`): [`ProjectileInst`](mw.ProjectileInst.md) 

按照对象发射器当前参数生成的投掷物对象

#### Parameters

| `childObjectId` `string` |  发射对象的 id。 range: 字符串长度取决于 ID 长度 |
| :------ | :------ |
| `target` [`GameObject`](mw.GameObject.md) |  追踪目标 |
| `targetingAcceleration?` `number` |  追踪加速度 default: 10000 range: 不做限制 type: 浮点数 |
| `startPosition?` [`Vector`](mw.Vector.md) |  发射起始位置 default: 发射对象的位置 |
| `direction?` [`Vector`](mw.Vector.md) |  发射起始方向 default: 发射对象的正前方 |
| `isAllClientLaunch?` `boolean` |  仅在发射单客户端对象是有效, 是否广播到所有客户端发射实例 default: false |

#### Returns

| [`ProjectileInst`](mw.ProjectileInst.md) | 投掷物实例 |
| :------ | :------ |

::: warning Precautions

发射后再更新其他属性无法对本次发射的子弹产生影响;
当在服务端调用方法广播，追踪模式发射时，会自带一个追踪的加速度，速度表现和预期会有差异

:::

<span style="font-size: 14px;">
使用示例:创建一个脚本放置在对象栏中，在脚本中复制下列"Example_ObjectLauncher_OnHomingFail"的代码保存，运行游戏，场景中将会生成一个对象发射器、一个用于发射的球以及一个NPC目标。给发射器对应事件的委托绑定函数。按下按键”1“，发射球并追踪NPC。设置对象代码如下：
</span>

@Component
 export default class Example_ObjectLauncher_Acceleration extends Script {

     protected async onStart(): Promise<void> {

         // 下列逻辑在服务端执行
         if(SystemUtil.isServer()) {
             // 在世界坐标（200，0，25）异步生成一个火箭
             let rocket = await GameObject.asyncSpawn("162807") as Model;
             rocket.worldTransform.position = new Vector(2000, 0, 25);

             // 异步生成对象发射器
             let myLauncher = await GameObject.asyncSpawn("ObjectLauncher") as ObjectLauncher;

             // 设置发射初始速度为1
             myLauncher.initialSpeed = 1;
             // 设置发射最大速度为1000
             myLauncher.maxSpeed = 1000;
             // 设置发射加速度为200
             myLauncher.acceleration = 200;
             // 设置碰撞半径为25
             myLauncher.capsuleRadius = 25;
             // 设置碰撞半长为25
             myLauncher.capsuleHalfLength = 25;
             // 开启反弹
             myLauncher.isShouldBounce = true;
             // 设置重力缩放为0
             myLauncher.gravityScale = 0;
             // 设置旋转不跟随速度方向
             myLauncher.isRotationFollowsVelocity = false;
             // 运动时间为10s
             myLauncher.lifeSpan = 10;

             // 添加客户端发送的”LAUNCH“事件监听器，将火箭朝上方发射。
             Event.addClientListener("LAUNCH", () => {
                 myLauncher.spawnProjectileInstanceLaunch(rocket.gameObjectId, rocket.worldTransform.position, new Vector(0, 0, 1));
                 rocket.localTransform.rotation = new Rotation(0, 90, 0);
             });
         }

         // 下列逻辑在客户端执行
         if(SystemUtil.isClient()) {
             // 添加一个按键方法：按下按键”1“，向服务端派送一个”LAUNCH“事件，发射一个球。
             InputUtil.onKeyDown(Keys.One, () => {
                 Event.dispatchToServer("LAUNCH");
             });
         }
     }
 }

___

### spawnProjectileInstanceLaunchToTarget <Score text="spawnProjectileInstanceLaunchToTarget" /> 

• **spawnProjectileInstanceLaunchToTarget**(`childObjectId`, `target`, `targetingAcceleration?`, `startPosition?`, `direction?`, `isAllClientLaunch?`): [`ProjectileInst`](mw.ProjectileInst.md) 

按照对象发射器当前参数生成的投掷物对象

#### Parameters

| `childObjectId` `string` |  发射对象的 id。 range: 字符串长度取决于 ID 长度 |
| :------ | :------ |
| `target` [`GameObject`](mw.GameObject.md) |  追踪目标 |
| `targetingAcceleration?` `number` |  追踪加速度 default: 10000 range: 不做限制 type: 浮点数 |
| `startPosition?` [`Vector`](mw.Vector.md) |  发射起始位置 default: 发射对象的位置 |
| `direction?` [`Vector`](mw.Vector.md) |  发射起始方向 default: 发射对象的正前方 |
| `isAllClientLaunch?` `boolean` |  仅在发射单客户端对象是有效, 是否广播到所有客户端发射实例 default: false |

#### Returns

| [`ProjectileInst`](mw.ProjectileInst.md) | 投掷物实例 |
| :------ | :------ |

::: warning Precautions

发射后再更新其他属性无法对本次发射的子弹产生影响;
当在服务端调用方法广播，追踪模式发射时，会自带一个追踪的加速度，速度表现和预期会有差异

:::

<span style="font-size: 14px;">
使用示例:创建一个脚本放置在对象栏中，在脚本中复制下列"Example_ObjectLauncher_OnHomingFail"的代码保存，运行游戏，场景中将会生成一个对象发射器、一个用于发射的球以及一个NPC目标。给发射器对应事件的委托绑定函数。按下按键”1“，发射球并追踪NPC。设置对象代码如下：
</span>