Integration Profiles Overview
Purpose of Integration Profiles
Integration profiles provide standardized metadata schemas for specific asset types and use cases. Each profile defines:
- Required properties
- Optional properties
- Validation rules
- Implementation patterns
Profiles ensure consistent metadata across platforms while addressing domain-specific requirements.
Available Profiles
MVMD includes the following integration profiles:
Profile | Purpose | Status |
---|---|---|
Attachable | Items that can be attached to avatars (wearables, equipment) | Proposed |
Avatar | Virtual character metadata | Proposed |
Basic | Core metadata for all assets | Proposed |
Composable 3D NFT | Composable NFT metadata | Proposed |
Digital Twin | Physical-digital representation | Proposed |
Equipable | Equipment system metadata | Proposed |
Future Profiles | Planned developments | In planning |
Identity | Identity information | Proposed |
Interactable | Interactive object metadata | Proposed |
Royalty | Revenue and rights metadata | Proposed |
Scene | Virtual environment metadata | Proposed |
Vehicle | Vehicle asset metadata | Proposed |
Wearable | Wearable item metadata | Proposed |
Profile Structure
Each integration profile follows a consistent structure:
- Purpose and Use Cases: Description and intended applications
- Profile Overview: General description of what the profile covers
- Required Properties: Essential metadata properties
- Optional Properties: Additional metadata enhancements
- Standards Integration: How the profile works with technical standards
- Examples: Basic, standard, and complete examples showing usage
- Validation: How to validate against profile requirements
- Implementation Considerations: Best practices and tips
- Common Issues: Troubleshooting guidance
- Related Profiles: Links to related profiles
Schema Validation
Each profile has a corresponding JSON Schema validation file that can be used to validate your metadata:
Implementation Approach
When implementing integration profiles:
- Start with the Basic Profile
- Add domain-specific profiles as needed
- Validate against profile schema files
- Focus on required properties first
- Add optional properties based on your specific needs
Use Case-Based Selection
Select profiles based on your specific use cases:
- Avatar Customization: Avatar + Attachable
- Virtual Stores: Basic + Attachable + Royalty
- Interactive Environments: Scene + Interactable
- Virtual Items with Utility: Attachable + Interactable
- Digital Ownership: Basic + Composable 3D NFT
Cross-References to Implementation Guides
For practical implementation guidance, see these related resources:
Next Steps
- Review the Basic Profile for fundamental implementation
- Identify the profiles most relevant to your assets
- Implement the minimum required properties
- Extend with optional properties as needed
- Validate your implementation using the Schema Validation Tools
Related Standards
Profiles integrate with these technical standards:
- Schema.org: Core vocabulary for all profiles
- glTF: 3D model format for visual assets
- USD: Universal Scene Description for complex assets
- OpenXR: XR-specific implementation patterns
- C2PA: Authentication and verification
Contributing
The MVMD community welcomes contributions to existing profiles and proposals for new profiles:
- Fork our GitHub repository
- Create a new branch for your profile changes
- Follow the standard profile structure
- Include examples and validation rules
- Submit a pull request
Related Resources
- Types of Assets: Core asset classifications
- Namespaces: Standard-specific metadata properties
- Implementation Best Practices: General metadata guidance
- Profile Specifications (JSON Schema)
- Schema Validation Documentation
- Available Schema Files
Related Namespaces
- Schema.org: Core vocabulary for integration profiles
- 3D Standards: Implementation patterns for 3D assets
- Geospatial Standards: Location data patterns
- Trust & Provenance: Authentication and verification
- OpenXR Standards: XR-specific implementation patterns