# MD360Player4Android

**Repository Path**: huyistudio/MD360Player4Android

## Basic Information

- **Project Name**: MD360Player4Android
- **Description**: 全景播放器。竟然没有用JNI！！！！https://github.com/ashqal/MD360Player4Android.git
- **Primary Language**: Android
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2016-03-07
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MD360Player4Android
It is a lite library to render 360 degree panorama video for Android.

## Preview
![ScreenShot](https://github.com/ashqal/MD360Player4Android/raw/master/app/demo/preview.jpg)
* [Gif Preview(5.2M)](https://github.com/ashqal/MD360Player4Android/raw/master/app/demo/DemoPreview.gif)
* [Demo Preview on YouTube](https://youtu.be/_m1f2I3i-pg)

## Demo APK
[MD360PlayerDemo.apk(21.7M, 360 demo video included)](https://github.com/ashqal/MD360Player4Android/raw/master/app/demo/MD360PlayerDemo.apk)

## NOTICE
* OpenGLES 2.0 required
* Android 4.0.3 (IceCreamSandwich API-15) required

## Gradle
```java
compile 'com.asha:vrlib:0.1'
```

## USAGE
There are two way to use this library depend on your requirement,
### Using MDGLSurfaceView
**STEP1** define `com.asha.vrlib.MDGLSurfaceView` in the layout xml.
```java
...
   <com.asha.vrlib.MDGLSurfaceView
       android:id="@+id/md_surface_view"
       android:layout_width="match_parent"
       android:layout_height="match_parent" />
...
```

**STEP2** attach the `android.view.Surface` to your MediaPlayer or something else when the surface is ready.
```java
public class MDGLSurfaceViewDemoActivity extends MediaPlayerActivity {

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_md_gl_surface);

        MDGLSurfaceView mGLSurfaceView = (MDGLSurfaceView) findViewById(R.id.md_surface_view);
        mGLSurfaceView.init(new MD360Renderer.IOnSurfaceReadyListener() {
            @Override
            public void onSurfaceReady(Surface surface) {
                //MediaPlayer or something else.
                getPlayer().setSurface(surface);
            }
        });
    }
}
```

### More Flexible Way: MD360Renderer
**STEP1** build a `MD360Renderer` and attach the `android.view.Surface`.
```java
public class MD360RenderDemoActivity extends MediaPlayerActivity {

    private MD360Renderer mRenderer;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_md_render);

        mRenderer = MD360Renderer.with(this)
                .listenSurfaceReady(new MD360Renderer.IOnSurfaceReadyListener() {
                    @Override
                    public void onSurfaceReady(Surface surface) {
                        getPlayer().setSurface(surface);
                    }
                })
                .build();
                
        // init OpenGL
        initOpenGL(R.id.surface_view);
    }
}
```

**STEP2** init OpenGL by yourself, and set the `MD360Renderer` to your `android.opengl.GLSurfaceView`
```java
private void initOpenGL(int glSurfaceViewResId) {
    mGLSurfaceView = (GLSurfaceView) findViewById(glSurfaceViewResId);

    if (GLUtil.supportsEs2(this)) {
        // Request an OpenGL ES 2.0 compatible context.
        mGLSurfaceView.setEGLContextClientVersion(2);

        // Set the renderer to our demo renderer, defined below.
        mGLSurfaceView.setRenderer(mRenderer);
    } else {
        mGLSurfaceView.setVisibility(View.GONE);
        Toast.makeText(MD360RenderDemoActivity.this, "OpenGLES2 not supported.", Toast.LENGTH_SHORT).show();
    }
}
```

## Reference
* [HTY360Player(360 VR Player for iOS)](https://github.com/hanton/HTY360Player)
* [NitroAction360(VR player for Android)](https://github.com/Nitro888/NitroAction360)
* [Learn-OpenGLES-Tutorials](https://github.com/learnopengles/Learn-OpenGLES-Tutorials)

## LICENSE
```
The MIT License (MIT)

Copyright (c) 2016 Asha
```