Skip to main content

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:

ProfilePurposeStatus
AttachableItems that can be attached to avatars (wearables, equipment)Proposed
AvatarVirtual character metadataProposed
BasicCore metadata for all assetsProposed
Composable 3D NFTComposable NFT metadataProposed
Digital TwinPhysical-digital representationProposed
EquipableEquipment system metadataProposed
Future ProfilesPlanned developmentsIn planning
IdentityIdentity informationProposed
InteractableInteractive object metadataProposed
RoyaltyRevenue and rights metadataProposed
SceneVirtual environment metadataProposed
VehicleVehicle asset metadataProposed
WearableWearable item metadataProposed

Profile Structure​

Each integration profile follows a consistent structure:

  1. Purpose and Use Cases: Description and intended applications
  2. Profile Overview: General description of what the profile covers
  3. Required Properties: Essential metadata properties
  4. Optional Properties: Additional metadata enhancements
  5. Standards Integration: How the profile works with technical standards
  6. Examples: Basic, standard, and complete examples showing usage
  7. Validation: How to validate against profile requirements
  8. Implementation Considerations: Best practices and tips
  9. Common Issues: Troubleshooting guidance
  10. 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:

  1. Start with the Basic Profile
  2. Add domain-specific profiles as needed
  3. Validate against profile schema files
  4. Focus on required properties first
  5. Add optional properties based on your specific needs

Use Case-Based Selection​

Select profiles based on your specific use cases:

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

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:

  1. Fork our GitHub repository
  2. Create a new branch for your profile changes
  3. Follow the standard profile structure
  4. Include examples and validation rules
  5. Submit a pull request