-
Notifications
You must be signed in to change notification settings - Fork 3
Numbers that appear in square brackets indicate the minimum version of PlayX required for that feature.
This function returns true if there is an instance of the PlayX player entity.
The PlayX player entity is returned if it exists; nil is returned otherwise. The class name of the PlayX entity is gmod_playx.
Returns whether the JW player is enabled.
Returns the URL of the JW player being used. This may return an empty string, but it should not return nil.
Returns whether the JW player is configured for YouTube. Note that the return of this function can still be true even if PlayX.IsUsingJW() returns false.
Checks whether to see a user is permitted to use PlayX. By default, this function will return true for administrators and super administrators, and false for everyone else. This behavior can be overridden by defining a particular callback (see Callbacks).
Parameters:
- ply: A player entity
Create a PlayX player where a user is looking. The model path can be of any usable model, but it is best if you use a model with a defined screen (see Defining Screens). However, PlayX will use an algorithm to lay a screen over the model if a screen has not been defined for it. Do not depend on the algorithm from not changing in the future, however.
This function will make sure that a PlayX player isn’t already spawned, but it will not check to see whether the user has permissions to spawn the player. true will be returned if the operation was successful, otherwise false will be returned, followed by an error message as a string.
Parameters:
- ply: A player entity.
- model: The model to use.
void PlayX.OpenMedia(string provider, string uri, number start, bool forceLowFramerate, bool useJW, number ignoreLength)
Plays media. This is the function that you want to, and should call, if you want to play something. This function will return the table returned from the provider if successful, otherwise false as the first returned value, followed by the error message as a string written in English as the 2nd returned value. If you provide information about a piece of media that PlayX does not know how to play, an error will be returned. If there is no PlayX player is spawned (PlayX.PlayerExists() will return false), then the function will return an error. No permission checks are done in this function.
Parameters:
- provider: The name of a registered provider, or an empty string to use auto-detection.
- uri: The URI to pass to the provider.
- start: Number of seconds to skip in the video; optional; can be nil to indicate that the media should be played from the beginning.
- forceLowFramerate: Whether to force the playing media into low frame rate mode; optional; can be nil to indicate that low frame rate mode should not be on.
- useJW: Specify whether the JW player should be used; optional; can be “nil,” which will use the default option: use the JW player.
- ignoreLength: Specify whether to ignore the length of the video and disable the auto-close on video end feature. This parameter has no effect if the auto-close on video end feature is not enabled.
Stops whatever is currently playing. This function checks to see whether something is currently playing, and will do nothing, silently, if nothing was playing.
This sets the length of the currently playing. The information is for metadata purposes, and calling this function is not required. Some providers have support for automatically fetching the length of a piece of media, so you do not need to call this function.
However, information about a video’s length is required if it is going to support the auto-close on end feature.
void PlayX.BeginMedia(string handler, string uri, number start, number resumeSupported, bool lowFramerate, number length, table handlerArgs, [1.1] string provider, [1.1] string identifier, [1.1] string title)
This function is deeper in the procedure for calling a video — it prepares the media for being played, it sets the “current playing media” state, and it will tell clients about the media that now needs to be played. Generally, you do not need to call this function, as you can get by by calling PlayX.OpenMedia. However, you may want to call this function if you want to skip the whole provider identification stage and directly play a video using a handler of choice. See the Concepts page to understand the difference between a provider and a handler.
Note that this function does not check to see if there is a PlayX player spawned, nor does it know if the particular combination of handler, URI, and handler arguments is supported by the client. Therefore, you must be careful.
Parameters:
- handler: The name of the handler is used.
- uri: URI to be passed to the handler.
- start: Number of seconds to skip. This value must be a number.
- resumeSupported: Whether resume is supported. Required argument.
- lowFramerate: Whether to use low framerate mode. Required argument.
- length: The length of the video in seconds. Must be a number greater than or equal to 0. Required argument.
- handlerArgs: Additional arguments for the handler. Required argument.
- provider: [1.1] Name of provider. Must be a string, but can be empty.
- identifier: [1.1] Identifier. Must be a string, but can be empty.
- title: [1.1] Title of the media. Must be a string, but can be empty.
Analogous to PlayX.BeginMedia(), except this function ends the currently playing media. This function does not check to see whether something is playing.
Function to send the necessary message(s) to inform a client that media is beginning. This is an internal function, and you should not need to call it. This function will not handle well if it is called after some time has passed since the media has started (it will not compensate for that).
Function to send the necessary message(s) to inform a client that nothing is playing now. This is an internal function, and you should not need to call it.
Sends a message to a player that causes the PlayX model selection dialog to appear.