PlayAudioStreamForPlayer

Iš GTA-Online Wikipedia.
Peršokti į: navigaciją, paiešką

PlayerPlaySound

Funkcijos pavadinimas PlayerPlaySound
Sintaksė
Reikalavimai nėra
Kategorija Garsų Funkcijos.png Garsų Funkcijos
Biblioteka a_players.inc
Atsiradimas 0.3d RC1
Pakeitimai 0.3d RC2, 0.3d RC3-2

Aprašymas

Funkcija skirta pradėti garso transliaciją nurodytam žaidėjui. Garsas gali būti girdimas tam tikroje vietoje arba visur, priklausomai nuo pasirinktų parametrų reikšmių.

Sintaksė

(playerid, url[], Float:posX = 0.0, Float:posY = 0.0, Float:posZ = 0.0, Float:distance = 50.0, usepos = 0)

Privalomi parametrai

Šis parametras yra privalomas.playerid Žaidėjo ID, kuriam bus pradedama
Šis parametras yra privalomas.url[] Garso transliacijos adresas.

Neprivalomi parametrai

Šis parametras nėra privalomas.Float:posXVietos, kurioje bus girdimas garsas, X koordinatė. Numatytoji reikšmė 0.0.
Šis parametras nėra privalomas.Float:posYVietos, kurioje bus girdimas garsas, Y koordinatė. Numatytoji reikšmė 0.0.
Šis parametras nėra privalomas.Float:posZVietos, kurioje bus girdimas garsas, Z koordinatė. Numatytoji reikšmė 0.0.
Šis parametras nėra privalomas.Float:distanceAtstumas, kuriuo bus girdima transliacija nuo transliavimo vietos. Numatytoji reikšmė 50.0.
Šis parametras nėra privalomas.useposTransliavimo vietos bei atstumo naudojimas. Nustačius reikšmę į 0, transliacija bus girdima visose vietose, 1 - garsas sklis tik nurodytoje teritorijoje. Numatytoji reikšmė 0.


Grąžinama reikšmė:
Ši funkcija neturi grąžinamos reikšmės.

Pavyzdys

Transliacijos paleidimas

Komanda skirta pradėti transliaciją visose vietose nurodytam žaidėjui.

Blantas 20:22, 4 lapkričio 2012 (EET)

public OnPlayerCommandText(playerid, cmdtext[])
{
        if (strcmp("/radija", cmdtext, true) == 0)
        {
                PlayAudioStreamForPlayer(playerid, "http://www.radijas.fm/media/_catalog/www.radijas.fm-radijo-stotis-zipfm.pls");
                return 1;
        }
        return 0;
}

Papildoma

  • Šioje funkcijoje galimi naudoti transliacijų tipai: SHOUTcast, Icecast bei atskiros garso bylos.
  • Galimi garso bylų formatai: Mp3, Ogg/Vorbis.
  • Pradėjus transliaciją, žaidėjas apatiniame dešinės ekrano pusės kampe matys informaciją apie transliuojamą kūrinį.
  • Pradėjus transliaciją, į pokalbių langą bus atspauzdinamas pranešimas su transliacijos adresu. Šį pranešimą, žaidėjas gali išjungti panaudojęs kliento komandą „/audiomsg“.
  • Pasibaigus transliacijai, žaidėjas nebegirdės transporto priemonėje grojamų radijo stočių. Norint to išvengti, žaidėjui reikia sugroti žaidimo garsus, kurių ID 1068 bei 1069, su tam tikra pauze tarp kiekvieno garso.
  • Garso transliacija negirdima žaidėjams, kurie yra išjungę transporto priemonių radijo garso lygį pačio žaidimo nustatymuose.

Istorija

Release Candidate
0.3d RC1 Nuo šiol SA-MP palaiko Shoutcast, Icecast transliacijas bei garso įrašo paleidimą.
0.3d RC2 Įdėta nauja kliento komanda „/audiomsg“, kuri išjungia automatinį pranešimą apie prisijungimą prie garso transliacijos.
0.3d RC3-2 Ištaisyta klaida, kuri nesustabdydavo pradėtos audio transliacijos, pradėjus transliuoti kitą.

Rekomenduojama

Siūlome patikrinti žemiau išvardintas funkcijas, kurios susijusios su PlayAudioStreamForPlayer veikimu.

  • PlayAudioStreamForPlayer: Pradėti garso transliaciją.
Asmeniniai įrankiai
San Andreas Multiplayer