Function bz_sendPlayCustomLocalSound

src/bzfs/bzfsAPI.cpp:3567–3603

//-------------------------------------------------------------------------

BZF_API bool bz_sendPlayCustomLocalSound(int playerID, const char* soundName,
                                         const float* pos) {
  if (playerID == BZ_SERVER || !soundName) {
    return false;
  }

  NetMessage netMsg;

  uint8_t bits = 0;
  if (pos != NULL) {
    bits |= SoundPosition;
  }

  netMsg.packUInt8(LocalCustomSound); // sound type
  netMsg.packUInt8(bits);
  netMsg.packStdString(std::string(soundName));
  if (pos != NULL) {
    netMsg.packFVec3(fvec3(pos[0], pos[1], pos[2]));
  }

  if (playerID == BZ_ALLUSERS) {
    for (int i = 0; i < curMaxPlayers; i++) {
      GameKeeper::Player* p = GameKeeper::Player::getPlayerByIndex(i);
      if (p && p->caps.canPlayRemoteSounds) {
        netMsg.send(p->netHandler, MsgCustomSound);
      }
    }
  }
  else {
    GameKeeper::Player* player = GameKeeper::Player::getPlayerByIndex(playerID);
    if (player && player->caps.canPlayRemoteSounds) {
      netMsg.send(player->netHandler, MsgCustomSound);
    }
  }

  return true;
}

// custom pluginHandler
BZF_API bool bz_registerCustomPluginHandler(const char* extension, bz_APIPluginHandler* handler) {