@readyplayerme/rpm-react-sdk
v0.1.5
Published
Ready Player Me React SDK
Downloads
524
Readme
⚠️ This package is deprecated and will not receive new updates.
Please use the following packages instead:
Ready Player Me - React Avatar Creator package here: https://github.com/readyplayerme/rpm-react-avatar-creator
Ready Player Me - Visage package here: https://github.com/readyplayerme/visage
Ready Player Me React SDK
Ready Player Me React SDK is a set of components and helper methods to help implementing Ready Player Me into React projects. With this SDK you can display Ready Player Me editor in your React project, create, edit and display avatars.
You can visit SDK Storybook and test the components here: https://readyplayerme.github.io/rpm-react-sdk
Codesandbox examples are available here: https://codesandbox.io/s/rpm-react-sdk-yii76z
Installation
Ready Player Me React SDK is available as an npm package.
npm i @readyplayerme/rpm-react-sdk
Usage
import { AvatarCreatorViewer } from '@readyplayerme/rpm-react-sdk';
export default function App() {
return (
<div>
<AvatarCreatorViewer subdomain="demo"/>
</div>
);
}
https://user-images.githubusercontent.com/3163281/235168912-a9dacd91-af3a-4b35-81c3-b025e12e333a.mp4
Components
AvatarCreator
AvatarCreator component helps you load Ready Player Me in an iframe where you can edit your avatar and receive your avatar URL as a post message once your avatar is exported.
Parameters
subdomain [required]: string
- Your Ready Player Me subdomain. You can get one from Ready Player Me Studio.
editorConfig [optional]: EditorConfig
- Editor Configuration is where you can set url properties of Ready Player Me editor. Read more about these options in Ready Player Me documentations.
avatarConfig [optional]: AvatarConfig
- Avatar Configuration is that changes the optimization properties of the generated GLB avatar model. Read more about these options in Ready Player Me documentations.
onAvatarExported [required]: (url: string) => void
- Callback function that is called when avatar is exported.
onUserSet [optional]: (userId: string) => void
- Callback function that is called when user id is set.
Example
const config: EditorConfig = {
clearCache: true;
bodyType: 'halfbody';
quickStart: 'false';
language: 'tr';
}
const avatarConfig: AvatarConfig = {
meshLod: 2,
textureAtlas: 512,
morphTargets: 'ARKit',
pose: 'T',
};
const handleOnUserSet = (userId: string) => {
console.log(`User ID is: ${userId}`)
}
const handleOnAvatarExported = (url;: string) => {
console.log(`Avatar URL is: ${url}`)
}
<AvatarCreator subdomain="demo" editorConfig={config} avatarConfig={avatarConfig}
onUserSet={handleOnUserSet} onAvatarExported={handleOnAvatarExported}/>
AvatarCreatorViewer
Avatar Creator component is the combination of AvatarCreator component and Ready Player Me Visage components that helps load the generated avatar with the given configurations into a 3D canvas where you can display it.
Parameters
subdomain [required]: string
- Your Ready Player Me subdomain. You can get one from Ready Player Me Studio.
editorConfig [optional]: EditorConfig
- Editor Configurations where you can set url properties of Ready Player Me editor. Read more about these options in Ready Player Me documentations.
avatarConfig [optional]: AvatarConfig
- Avatar Configurations that changes the optimization properties of the generated GLB avatar model. Read more about these options in Ready Player Me documentations.
viewerConfig [optional]: ViewerConfig
- Viewer Configurations that changes the properties of the 3D canvas where the avatar is displayed.
loadingNode [optional]: JSX.Element | string
- Loading node that is displayed while avatar is loading.
onUserSet [optional]: (id: string) => void
- Callback function that is called when user id is set.
onAvatarLoaded [optional]: () => void
- Callback function that is called when avatar is loaded.
onAvatarExported [optional]: (url: string) => void
- Callback function that is called when avatar is exported.
Example
const editorConfig: EditorConfig = {
clearCache: true;
bodyType: 'halfbody';
quickStart: 'false';
language: 'tr';
};
const avatarConfig: AvatarConfig = {
meshLod: 2,
textureAtlas: 512,
morphTargets: 'ARKit',
pose: 'T',
};
const viewerConfig: ViewerConfig = {
animationUrl: "...",
style: {backgroundColor: "#ddd"}
};
const handleOnUserSet = (id: string) => {
console.log(`User ID is: ${id}`)
}
const handleOnAvatarExported = (url: string) => {
console.log(`Avatar URL is: ${url}`)
}
const handleOnAvatarLoaded = () => {
console.log(`Avatar is loaded`)
}
<AvatarCreatorViewer subdomain="demo"
editorConfig={editorConfig} avatarConfig={avatarConfig} viewerConfig={viewerConfig}
onUserSet={handleOnUserSet} onAvatarExported={handleOnAvatarExported} onAvatarLoaded={handleOnAvatarLoaded}/>
Using AvatarCreator with Visage
If you would like to use Visage with it's full capability to edit camera and light properties of the scene and more, you can use AvatarCreator component and Visage components together.
import { Avatar } from '@readyplayerme/visage';
import { AvatarEditor, AvatarViewer } from '@readyplayerme/rpm-react-sdk';
const subdomain = 'demo';
const editorConfig: EditorConfig = {
clearCache: true;
bodyType: 'fullbody';
quickStart: 'false';
language: 'tr';
};
export const YourCustomComponent = () => {
const [url, setUrl] = useState<string | undefined>(undefined);
const handleOnAvatarExported = (url: string) => {
setUrl(url);
}
return <div>
<AvatarCreator subdomain={subdomain} editorConnfig={editorConfig} onAvatarExported={handleOnAvatarExported} />
<Avatar modelSrc={url} />
</div>
}