/tutorials/fundamentals/coding-2/functions-and-events.md

Landingspagina voor hoofdstuk over het coderen van functies in Luau en het gebruik van evenementen op Roblox.

Serie beschrijving

Doelstellingen en vereisten

Inhoud van de serie

Functies en evenementen

Ervaringen

Avatar

Assets

Voorbeelden en projecten

Engine-API

Open Cloud-API

Studio

Analytics

Platform

Tutorials

Makerprogramma's

Onderwijs

Meer informatie

Deze methode is asynchroon en retourneert een 'Bewerking', die de huidige status van de bewerking weergeeft. Deze bevat een eindpuntpad dat je kunt opvragen om het daadwerkelijke antwoord en de bijbehorende metadata te verkrijgen. Zie de [documentatie]({longRunningOperationsLink}) over langlopende bewerkingen voor meer informatie. 

De volgende secties beschrijven de antwoord- en metadata-objecten die worden verstrekt wanneer een bewerking is voltooid.

Bèta-eindpunten zijn klaar voor openbaar gebruik. Ingrijpende wijzigingen zijn mogelijk, maar komen zelden voor.

Deze Open Cloud-documentatiepagina's worden op 31 maart 2026 verwijderd. Op dat moment word je automatisch doorgestuurd naar de nieuwe Open Cloud-documentatie. {linkStart}Meer informatie{linkEnd}

Deze oude Open Cloud-pagina's worden op 31 maart 2026 verwijderd en doorgestuurd. {linkStart}Meer informatie{linkEnd}

Experimentele eindpunten zijn klaar voor openbaar gebruik, maar kunnen af en toe ingrijpende wijzigingen ondergaan naarmate het API-contract wordt afgerond.

Dit eindpunt kan in de ervaring worden aangeroepen via {httpServiceLinkStart}HttpService{httpServiceLinkEnd} met een API-sleutel.

Dit veld kan worden ingesteld bij het maken van een bron, maar mag niet worden gewijzigd door latere verzoeken.

Deze velden kunnen worden ingesteld bij het maken van een bron, maar mogen niet worden gewijzigd door latere verzoeken.

Dit veld kan worden verstrekt in verzoeken, maar wordt nooit opgenomen in antwoorden.

Verouderde verificatiemethode. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Per API-sleutel: {maxInPeriod} verzoeken elke {periodInSeconds} seconden per IP-adres

Vereist geen verificatie om aan te roepen. Heeft doorgaans aanzienlijk lagere snelheidslimieten. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Voor elke groepering hoeft slechts één van de volgende velden in het schema te worden opgegeven, de overige kunnen worden uitgesloten.

Je kunt je op elk moment weer aanmelden. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de oude documenten. {linkStart}Geef feedback.{linkEnd}

Je kunt je op elk moment afmelden. Dan word je teruggestuurd naar de oude referentiepagina's. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de vernieuwde documenten. {linkStart}Geef feedback.{linkEnd}

Dit veld kan worden ingesteld voor antwoorden, maar wordt genegeerd in verzoeken.

Opmerking: snelheidslimieten kunnen lager zijn tijdens perioden met veel verkeer. Bepaalde eindpunten hebben aanvullende snelheidslimieten. [Meer informatie over snelheidslimieten]({link}).

{limit} verzoeken per dag voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per uur voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per seconde voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut per eigenaar van API-sleutel

{limit} verzoeken per dag per app-gebruiker

{limit} verzoeken per uur per app-gebruiker

{limit} verzoeken per minuut per app-gebruiker

{limit} verzoeken per seconde per app-gebruiker

{limit} verzoek(en) per seconde per eigenaar van API-sleutel

Het bereik bepaalt welke toestemmingen je inloggegevens hebben. Je inloggegevens hebben alleen toegang tot de eindpunten die worden ondersteund door het bereik dat je hebt geselecteerd.

Stabiele eindpunten zijn productieklaar en zullen tijdens hun levensduur bijna nooit ingrijpende wijzigingen ondergaan.

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts}

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts} en {optionalParts}

Doeltypen worden gebruikt om de bronnen te beperken waarvoor je inloggegevens toegang hebben. Alleen de geselecteerde bronnen kunnen worden gebruikt, zelfs als je account toegang heeft tot aanvullende bronnen. Het is mogelijk dat een bepaald bereik geen doelonderdelen heeft. In deze gevallen kunnen al je relevante bronnen worden gebruikt. 

Het universele onderdeel op het hoogste niveau hoeft niet te worden geselecteerd voor API-sleutels die eigendom zijn van de gebruiker. In dit geval heeft je API-sleutel toegang tot al je ervaringen die eigendom zijn van gebruikers en ervaringen die eigendom zijn van groepen waarvoor je de juiste groepsrechten hebt.

'Probeer het uit' wordt nog niet ondersteund voor eindpunten waarvoor een API-sleutel of OAuth 2.0-verificatie vereist is

Cookie-authenticatie is uitgeschakeld voor bewerkingen met een hoog risico om veiligheidsredenen.

Eindpunten met kritiek risico zijn uiterst gevoelig en 'Probeer het uit' is uitgeschakeld om veiligheidsredenen

Opmerking: authenticatieheaders zijn niet opgenomen in dit codevoorbeeld. Mogelijk moet je een authenticatieheader toevoegen om deze opdracht te kunnen uitvoeren.

Dit is een eindpunt met een hoog risico dat kritieke gegevens kan wijzigen of verwijderen. Wees uiterst voorzichtig bij het testen.

Dit API-eindpunt is geclassificeerd als HOOG RISICO en kan van invloed zijn op live gegevens of gebruikersaccounts.

Geverifieerde verzoeken aan API's met een hoog risico kunnen wijzigingen aanbrengen die niet ongedaan kunnen worden gemaakt. Controleer de parameters van je verzoek zorgvuldig voordat je verder gaat.

Dit is een eindpunt met een laag risico dat gegevens ophaalt. Dit is over het algemeen veilig om te testen.

Dit is een eindpunt met een gemiddeld risico dat gegevens wijzigt. Test voorzichtig met niet-kritieke accounts, aangezien wijzigingen permanent kunnen zijn.

Plak hier nooit tekst uit andere bronnen en stuur nooit informatie van deze pagina naar anderen om je account veilig te houden.

Je staat op het punt live API-eindpunten te testen met de daadwerkelijke inloggegevens van je account.

Ga alleen verder als je de implicaties begrijpt van de API-oproepen die je wilt uitvoeren. Lees de API-documentatie zorgvuldig door voordat je gaat testen.

API-oproepen worden gedaan met behulp van je geverifieerde sessie

Dit zijn echte API-oproepen die van invloed kunnen zijn op je account of gegevens

Snelheidslimieten en andere API-beperkingen zijn van toepassing

Sommige bewerkingen kunnen gegevens wijzigen of verwijderen

Dit eindpunt is vervangen door deze aanbevolen alternatieve eindpunten:

Het volgend bereik is vereist om dit eindpunt aan te roepen. Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer 
informatie over het genereren van de juiste sleutels.

Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer informatie over het genereren van sleutels.

De volgende eindpunten zijn beschikbaar op paden ten opzichte van de basis-URL.

Deze string is opgemaakt als een [FieldMask](/cloud/reference/types#fieldmask).

Een JSON-waarde kan 'null', 'boolean', 'string', 'number', 'array' of 'object' zijn.

Het volgende bereik is vereist om je OAuth 2.0-applicatie dit eindpunt te laten gebruiken. Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

De volgende objecten beschrijven payloads die worden geaccepteerd of geretourneerd. Raadpleeg elk afzonderlijk eindpunt voor meer informatie over wanneer deze objecten worden gebruikt.

Het volgende bereik is vereist om dit eindpunt aan te roepen.

Bronpaden

Deze string is opgemaakt als een [Tijdstempel](/cloud/reference/types#timestamp).

Niet aanbevolen

Je bekijkt de vernieuwde Open Cloud-referentie.

Je hebt je afgemeld voor de nieuwe Open Cloud-referentie.

Bekijk je factureringsaccounts voor advertenties.

Verleent toegang om factureringsaccounts te configureren en advertentietegoed te kopen.

Bekijk je advertentiecampagnes en hun prestaties.

Je advertentiecampagnes maken, bijwerken en beheren.

Hiermee kun je informatie over je assets bekijken.

Hiermee kun je assets uploaden naar en bijwerken op Roblox.

Hiermee kun je assetmachtigingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je assettoestemmingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je namens jou de status en resultaten van taken voor automatische instelling van avatars bekijken.

Hiermee kun je namens jou taken voor automatische instelling van avatars maken en beheren.

Geeft de mogelijkheid om badges van de gebruiker bij te werken.

Hiermee kun je informatie over je commerciële items bekijken.

Hiermee kun je wijzigingen aanbrengen in je gesynchroniseerde commerciële items.

Hiermee kun je informatie over je Connecties met handelaren bekijken.

Hiermee kun je je connecties met handelaren bewerken.

Hiermee kun je informatie over je Creatorwinkel-producten bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel wijzigen.

Geeft toegang om namens jou gegevensopslagplaatsen te maken.

Geeft toegang om namens jou gegevensopslagplaatsen te verwijderen.

Geeft toegang om een lijst met gegevensopslagplaatsen te lezen.

Geeft toegang om een snapshot van je gegevensopslagplaatsen te maken.

Geeft toegang om items in je gegevensopslagplaatsen te maken.

Geeft toegang om specifieke items te markeren voor verwijdering.

Geeft toegang om de items van je gegevensopslag te vermelden.

Geeft toegang om specifieke items in je gegevensopslagplaatsen te lezen.

Geeft toegang om de waarde, attributen en gebruikers van een item bij te werken.

Geeft toegang om revisies van de items van je gegevensopslag te verwijderen.

Geeft toegang om revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om gelezen revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om de configuratiegegevens van de ontwikkelaarsproducten van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de Developer Products van de geautoriseerde gebruiker te bewerken.

Hiermee kun je informatie over de omgevingen van je universum bekijken.

Hiermee kun je de omgevingen van je universum bewerken.

Geeft toegang om de configuratiegegevens van de game passes van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de game passes van de geautoriseerde gebruiker te bewerken.

Geeft toegang om informatie over de communityforums voor je account te bekijken.

Geeft toegang om informatie over de communityforums voor je account te beheren.

Hiermee kun je informatie over je community's bekijken.

Hiermee kun je lidmaatschapsverzoeken voor de community en rolwijzigingen van lager gerangschikte communityleden beheren voor je account.

Hiermee kun je de eigenschapsgegevens van een instantie bekijken.

Hiermee kun je de property-gegevens van instanties wijzigen (momenteel alleen ondersteuning voor scripts).

Hiermee kun je informatie over je inventaris bekijken.

Geeft toegang om gebruikersassets te beheren.

Geeft toegang om je badges te beheren en Robux uit te geven.

Geeft toegang om de badges van de geautoriseerde gebruiker bij te werken.

Geeft toegang om je ontwikkelaarsproducten te beheren.

Geeft toegang om informatie te lezen over de ervaringen waarvoor je meldingen hebt ingeschakeld.

Geeft toegang om namens jou meldingen voor ervaringen in of uit te schakelen.

Geeft toegang om je community's te beheren.

Geeft toestemming om communitygegevens te lezen.

Verleent toestemmingen voor communitybeheer.

Geeft toegang om je lokalisatietabellen te lezen en te schrijven

Geeft toegang om teamsamenwerking te beheren voor alle ervaringen die je bezit.

Geeft toegang om je ervaringen en bepaalde informatie die aan je ervaringen is gekoppeld (bijv. lokalisatie-informatie) te beheren.

Geeft toegang om de lokalisatie-informatie van je ervaringen te lezen.

Geeft toegang om de lokalisatievoorkeuren van je ervaringen te wijzigen.

Geeft toegang om je gebruikersaccount te beheren.

Geeft toegang om de lokalisatievoorkeuren van de gebruiker te wijzigen.

Hiermee kun je de status, logs en resultaten van Luau-uitvoeringstaken voor de bijbehorende plaats bekijken.

Hiermee kun je nieuwe Luau-uitvoeringstaken voor de bijbehorende plaats maken.

Geeft toegang om asynchroon alle gegevensstructuren in het universum te flushen.

Geeft toegang om nieuwe wachtrijitems te maken.

Geeft toegang om gelezen items vooraan in de wachtrij te negeren.

Geeft toegang tot gelezen items vooraan in de wachtrij.

Geeft toegang om je geheugenopslagitems te lezen.

Geeft toegang om kaartitems te maken, bij te werken en te verwijderen.

Dit geeft de mogelijkheid om namens gebruikers berichten te publiceren.

Hiermee kun je meldingen vanuit je ervaring naar gebruikers sturen.

(Verouderd) Geeft toegang om een lijst met items in een genummerde gegevensopslag te lezen.

(Verouderd) Geeft toegang om een nieuw item in een genummerde gegevensopslag te maken.

Geeft toegang om items uit een genummerde gegevensopslag te vermelden.

Geeft toegang om items in een genummerde gegevensopslag te maken.

Hiermee kun je geheimen vermelden die aan je ervaring zijn gekoppeld.

Hiermee kun je geheimen maken en bijwerken die aan je ervaring zijn gekoppeld.

Met deze toestemming kun je een evaluatietaak indienen en het resultaat van de taak bekijken.

Geeft toegang om informatie over je abonnementsproducten te lezen.

Hiermee kun je namens jou informatie over miniaturen lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te maken of te wijzigen.

Geeft de mogelijkheid om game analytics te lezen.

Geeft de mogelijkheid om bronnen met betrekking tot game analytics te schrijven.

Geeft de mogelijkheid om plaatsinformatie te lezen.

Geeft de mogelijkheid om plaatsinformatie te bewerken.

Geeft toegang om nieuwe versies van ervaringen op Roblox te publiceren.

Hiermee kun je de miniaturen en de bijbehorende personalisatie-instellingen voor je ervaringen lezen.

Hiermee kun je de miniaturen uploaden en verwijderen en de bijbehorende personalisatie-instellingen voor je ervaringen beheren.

Geeft de mogelijkheid om informatie over ervaringen te lezen.

Geeft toegang om de ervaringen van de geautoriseerde gebruiker te bewerken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bekijken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bewerken.

Hiermee kun je meldingen bekijken die naar je account zijn gestuurd.

Geeft de mogelijkheid om de premium- en geverifieerde status van de gebruiker te lezen.

Hiermee kun je de sociale media-accounts van de geautoriseerde gebruiker bekijken.

Geeft de mogelijkheid om game-evenementen te lezen.

Geeft de mogelijkheid om game-evenementen te bewerken.

Dit schakelt de Single Sign-On-functionaliteit in.

Dit geeft toegang om je profielinformatie te lezen.

Deze functie geeft, indien mogelijk, onmiddellijk een resultaat, maar kan de thread die deze heeft aangeroepen, pauzeren totdat deze een waarde kan teruggeven.

Lees meer over {linkStart}mogelijkheden{linkEnd}.

{nameStart}naam{nameEnd} wordt niet meer ondersteund of onderhouden door Roblox.

Dit eindpunt wordt niet meer ondersteund of onderhouden door Roblox.

Deze wiskundige bewerking wordt niet meer ondersteund of onderhouden door Roblox.

Dit lid verschijnt niet in de objectbrowser en is niet bedoeld voor wijdverbreid gebruik.

Dit lid is alleen toegankelijk via de opdrachtbalk. Als je probeert dit lid vanuit scripts te openen, treedt er een fout op.

Deze functie kan de Lua-thread die deze heeft aangeroepen, niet pauzeren.

Als je probeert dit lid in scripts te openen, treedt er een fout op. Mogelijk kun je dit lid openen vanuit het eigenschappenvenster van Roblox Studio.

Dit lid verschijnt niet in de objectbrowser van Roblox Studio.

Je kunt geen instantie van deze klasse maken met de constructor Instance.new.

Roblox repliceert dit lid niet over de grens tussen server en client.

Lua-code heeft geen toegang tot dit lid. Mogelijk kun je de waarde ervan wijzigen vanuit het eigenschappenvenster in Roblox Studio.

Dit lid is toegankelijk vanuit OpenCloud Luau-uitvoeringstaken.

Het replicatiegedrag van dit object is afhankelijk van de speler die het bezit.

Dit lid is toegankelijk via de opdrachtbalk en plug-ins. Als je probeert dit lid vanuit scripts te openen, treedt er een fout op.

Dit lid is alleen-lezen. Als je probeert naar dit lid te schrijven, treedt er een fout op.

Deze eigenschap is alleen-lezen en kan veilig worden gelezen in niet-gesynchroniseerde threads. Als je probeert erin te schrijven, treedt er een fout op.

Er zijn alternatieve eindpunten beschikbaar die dit eindpunt vervangen.

Dit lid is alleen toegankelijk in CoreScripts.

Alleen Roblox CoreScripts hebben toegang tot dit lid en het is niet bruikbaar door spelers.

Je kunt vanuit meerdere threads veilig naar deze eigenschap lezen en schrijven.

Deze klasse is een singleton op het hoogste niveau. Haal een instantie van deze klasse op met de functie GetService.

Toegankelijk binnen callbacks die zijn gebonden via {link1Start}RunService:BindToSimulation(){link1End}. Neemt deel aan rollbacks. Zie {link2Start}serverautoriteit{link2End}.

Meerdere threads kunnen mogelijk naar deze eigenschap schrijven, dus het is onveilig om vanuit niet-gesynchroniseerde threads te lezen.

Deze functie pauzeert de Lua-thread die de functie heeft aangeroepen totdat deze een resultaat retourneert. Dit onderbreekt andere scripts niet.

Leerdoelen	Leer om code in herbruikbare stukken te plaatsen die functies worden genoemd. Begrijp wat het betekent dat code "in scope" is. Stel evenementen in binnen een spel en gebruik ze om de functies te vertellen wanneer ze moeten draaien. Oefen met het gebruik van functies en evenementen om vallen en knoppen te creëren.
Vereisten	Basiskennis van Roblox Studio, zoals het verplaatsen en roteren van onderdelen. Eerdere ervaring met het maken van Script-objecten en het gebruik van variabelen, eigenschappen en strings.

Artikel	Beschrijving
Code een functie	Stel stukken code in op een manier die alleen draait wanneer je het vertelt om te draaien.
Gebruik parameters en evenementen	Hoe je een functie codeert wanneer je nog niet alle informatie hebt.
Parameters oefenen - knoppen	Oefen met het gebruik van evenementen en parameters door een brug in de wereld te laten verschijnen met de druk op een knop.
Meerdere parameters en argumenten	Geef meerdere stukjes informatie tegelijk door aan een functie.